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2.12.20  show_effect_insg.c 

The  show_effect_msg  function  adds  new  special  effects  to  the  active  effects  table  in  active 
area  memory.  This  function  is  called  whenever  the  Simulation  Host  sends  a 
MSG_SHOW_EFFECT  message.  If  the  system  contains  two  backends,  show_effect_msg 
is  called  twice  (each  active  area  memory  has  its  own  active  effects  table). 

The  function  call  is  show_effect_msg(msgp,  pdbase,  vme_offset),  where: 

msgp  is  a  pointer  to  the  MSG_SHOW_EFFECrr  message 
pdbase  is  a  pointer  to  the  primary  database  block 
vme  ojfset  is  the  VME  address  offset  to  AAM 

show_effect_msg  finds  the  load  module  in  which  the  effect  is  to  be  placed,  then  adds  the 
effect  to  the  multiple-frame  effects  list. 


Called  By;  msg_show_effect 

Routines  Called;  FLND_LM 


Parameters: 


MSG_SHOW_EFFECT 

DB.INFO 

INT_4 


*msgp 

♦pdbase 

vme_offset 


Returns: 


none 
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2.13  Real-Time  Processing  (/cig/libsrc/librtt) 

The  Real-Time  Processing  CSC  is  responsible  for  setting  up  and  running  the  simulation 
using  messages  sent  from  the  Simulation  Host.  The  primary  tasks  performed  by  the 
functions  in  this  CSC  are  the  following; 

System  configuration 

•  Parses  the  command  line  entered  by  the  user  to  initialize  the  system. 

•  Configures  Ballistics. 

•  Opens  the  terrain  database  and  Dynamic  Elements  Database  (DED)  files. 

•  Configures  the  color  table. 

•  Configures  the  database. 

•  Downloads  trajectory  tables  to  Ballistics. 

•  Downloads  textures  data  to  the  ESIFA. 

•  Initiates  viewport  configuration  and  2-D  overlay  generation. 

Simulation  processing 

•  Processes  all  runtime  messages  sent  by  Simulation  Host. 

•  Performs  matrix  concatenations  to  adjust  the  viewport  displays  as  the 
simulated  vehicle  moves  and  rotates. 

•  Performs  model  control  on  other  vehicles  in  the  simulation  environment. 

Ballistics  interface 

•  Notifies  Ballistics  of  state  changes  and  changes  to  simulation  parameters 
(e.g.,  addition  of  static  vehicles). 

•  Forwards  requests  from  the  Simulation  Host  to  process  rounds  and 
trajectories,  obtain  terrain  feedback  data,  and  enable  AGL  processing. 

•  Processes  messages  returned  from  Ballistics. 

Database  management 

•  Loads  the  correct  portion  of  the  terrain  database  into  active  area  memory. 

•  Loads  new  rows  or  columns  as  necessary  during  the  simulation,  to  keep  the 
simulated  vehicle  in  the  center  of  active  area  memory. 

Database  feedback 

•  Provides  information  to  the  Simulation  Host  on  the  terrain  surrounding  the 
simulated  vehicle. 

Hardware  tests  (not  currently  implemented) 

•  Runs  hardware  tests  requested  by  the  Simulation  Host. 

File  control 

•  Transfers  files  to  and  from  the  CIG  based  on  Simulation  Host  requests. 
Miscellaneous 

•  Provides  functions  for  interfacing  to  the  Force  board. 

•  Provides  functions  for  interfacing  with  the  EVC  (Ethernet  VME  Controller). 

•  Allows  the  Gossip  user  to  display  calibration  images. 

•  Provides  a  mechanism  for  recording  message  packets  to  a  file. 

•  Manages  cloud  models. 

•  Builds  Ml  and  M2  gun  overlays  for  viewports  connected  to  T  backends. 
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At  startup,  various  functions  are  called  to  initialize  active  area  memory,  verify  that  the 
communications  interface  to  the  Simulation  Host  is  functional,  and  start  Ballistics.  The 
upstart  function  then  processes  the  messages  sent  by  the  Simulation  Host  to  place  the  CIG 
in  a  specified  state.  TTie  CIG  states  that  can  be  set  are: 

Database  setup  Prepares  the  CIG  to  run  a  simulation.  If  this  state  is 

requested,  upstart  passes  control  to  db_mcc_setup. 

Used  to  transfer  files  to  and  from  the  CIG.  If  this  state  is 
requested,  upstart  passes  control  to  file_control. 

Used  to  run  hardware  tests.  If  this  state  is  requested,  upstart 
passes  control  to  hw_test. 

Prepares  the  CIG  to  act  as  an  MCC  station.  This  mode  is 
not  currendy  used. 

If  database  setup  is  specified,  db_mcc_setup  processes  messages  from  the  Simulation  Host 
to  configure  the  viewports  (by  initiating  the  Viewport  Configuration  CSC)  and  the  2-D 
overlays  (by  initiating  the  2-D  Overlay  Compiler  CSC).  db_mcc_setup  also  loads  the 
terrain  database  and  Ae  dynamic  elements  database  (DED)  into  active  area  memory,  and 
processes  requests  to  download  trajectory  table  data.  Upon  another  state  change  request 
from  the  Simulation  Host,  db_mcc_setup  calls  simulation  to  start  the  simulation. 

During  the  simulation,  the  process_a_msg  function  (called  by  simulation)  processes  all 
runtime  messages.  These  messages  may  ask  to  move  or  rotate  dynamic  vehicles,  change 
gun  overlays,  pass  process  round  and  round  fired  messages  to  Ballistics,  or  change  other 
simulation  parameters.  process_a_msg  also  processes  the  hit  and  miss  messages  returned 
by  Ballistics. 

As  the  simulated  vehicle  moves  about  in  active  area  memory,  the  database  management 
functions  read  new  load  modules  in  from  the  terrain  database  as  necessary.  The  database 
feedback  functions  prepare  messages  describing  the  terrain  around  the  simulated  vehicle 
and  return  them  to  die  Simulation  Host  at  specified  intervals. 

When  the  Simulation  Host  sends  a  message  ending  the  simulation,  control  is  passed  back 
to  db_mcc_setup.  db_mcc_setup  then  initializes  the  configuration  tree  and  returns  control 
to  upstart. 

The  CSUs  in  the  Real-Time  Processing  CSC  are  identified  in  Figure  2-17  and  are  described 
in  this  section. 


File  control 
Test  mode 
MCC  setup 
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agptjnit.c 

dLman.c 

make_bbn.c 

bal_get_dbj30s.c 

download_bvols.c 

mkmtx_nt.c 

bal_get_lm_jgrid.c 

effecl_downcount.c 

model_mtx.c 

bal_routines.c 

file_oontrol.c 

mx2_hword.c 

ball_effect_add.c 

fxbvtofl.c 

open_dbase.c 

cal.c 

genericjm.c 

open_ded.c 

cigsimio_obj.c 

geMxJutJndex  .c 

otherveh_state.c 

close_db.c 

globaijnit.c 

pretend_veh.c 

clouds.c 

gun_overlays.c 

rowcoLrd.c 

config_ballistics.c 

hw_test.c 

rt_mailbox.c 

config_color_table.c 

init_sim.c 

rttjnit.c 

config_database.c 

load_dbase.c 

simulation.c 

db_mcc_setup.c 

load_esifa.c 

staticveh_remove.c 

debugjnitdr.c 

load_modules.c 

staticveh_state.c 

ded_gm_pool.c 

locjer.c 

sys_control.c 

ded_model_trace.c 

upstart.c 

Figure  2-17.  Real-Time  Processing  CSUs 


2.13.1  agpt_init.c 

The  agpt_init  function  is  not  used  in  the  standard  GTIOO  system. 


2.13.2  bal_get_db_pos.c 

The  bal_get_db_pos  function  finds  the  load  module  number  and  grid  number  of  a  given 
chord  point.  This  function  is  used  to  determine  the  load  module  and  grid  of  the  simulated 
vehicle's  current  position. 

The  function  call  is  baI_get_db_pos(pcrd,  liii_width,  lm_per_side),  where: 

pcrd  is  a  pointer  to  the  chord  data 
Im  width  is  the  width  of  a  load  module 

Im _per_side  is  the  number  of  load  modules  in  a  row  or  column  of  A  AM 


bal_get_db_pos  uses  the  FIND_LM  macro  (described  in  Appendix  B)  to  determine  the  load 
module  for  the  x  and  y  coordinates  specified  in  the  chord  data.  It  then  calculates  which  grid 
the  vehicle  occupies  within  the  load  module.  The  load  module  and  grid  number  are  placed 
in  the  chord  data  structure. 
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Called  By:  local_terram 


Routines  Called:  FIND_LM 


Parameters:  CHORD_DATA 

INT_4 

INT_4 


*pcrd 

lm_width 

lm_per_side 


Returns:  none 


2.13.3  bal_get_lm_grid.c 

The  bal_get_lm_grid  function  finds  the  load  modules  and  grids  in  the  database  that  are 
intersected  by  a  chord.  This  function  is  used  to  determine  which  four  grids  lie  around  the 
simulated  vehicle. 

The  function  call  is  bal_get_Im_grid(pcrd,  Im_per_side,  Im_size, 
lm_base_addr,  bal_search,  dvl_search,  ln[i_width),  where: 

pcrd  is  a  pointer  to  the  chord  data 

Im  j)er_side  is  the  number  of  load  modules  in  a  row  or  column  of  AAM 
lm_size  is  the  size  in  bytes  of  a  load  module 
Im  base  addr  is  the  load  module's  base  address 

bal  search  is  the  array  in  which  to  store  load  module  offsets  and  grid  words 
dvl  search  is  the  array  in  which  to  store  dynamic  module  path  data 
Im  width  is  the  width  of  a  load  module 

The  function  returns  TRUE  if  it  is  successful.  It  returns  FALSE  if  an  illegal  chord  (one 
longer  than  125  meters)  is  detected. 


Called  By: 

local_terrain 

Routines  Called: 

none 

Parameters: 

CHORD  DATA 

INT  4 

INT  4 

INT  4 

SEARCH  LIST 

INT  4 

INT_4 

pcrd[] 

lm_per_side 

lm_size 

lm_base_addr 

bal_search[] 

dvl_search[J 

lm_width 

Returns: 

1  (TRUE) 

0  (FALSE) 
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2.13.4  bal_routines.c 

The  functions  in  the  bal_routines.c  CSU  handle  the  interface  between  the  real-time  ‘■oftware 
and  the  Ballistics  Processing  CSC.  Many  of  these  routines  process  messages  passed  to 
and  from  Ballistics.  These  functions  are: 


•  sim_bal_init 

•  sim_bal_start 

•  sim_bal_fi:ame_rate 

•  sim_bal_req_pt_info 

•  sim_bal_agl_wanted 

•  sim_bal_process_msg 

•  sim_bal_process_tracer 

•  sim_bal_traj_chord 

•  sim_bal_round_fired 

•  sim_bal_static_add 

•  sim_bal_static_rem 

•  sim_bal_reset 

•  sim_bal_tf_veh_update 


2.13.4.1  sim_bal_init 

The  sim_bal_init  function  initializes  variables  used  in  Ballistics  messages.  This  function  is 
called  at  the  start  of  a  simulation. 

The  function  call  is  siin__bal_init().  sim_bal_init  initializes  the  following: 

•  Variables  used  when  processing  rounds  (estimated  impact  time  and  range). 

•  Parameters  used  in  the  Ballistics  "new  frame"  message. 

•  The  database  index. 

•  Variables  used  when  processing  chords. 


Called  By: 
Routines  Called: 
Parameters: 
Returns: 


init_simulation 

none 

none 

none 


2.13.4.2  siin_bal_start 

The  sim_bal_start  function  puts  Ballistics  into  the  run  state  and  tells  it  where  active  area 
memory  is.  This  function  is  called  at  the  start  of  a  simulation. 
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The  function  call  is  siin_bal_start(pdbase),  where  pdbase  is  a  pointer  to  the  primary 
database  control  block.  sim_bal_start  does  the  following: 

•  Sets  the  Ballistics  state  to  BX_RUN. 

•  Pushes  a  MSG_BO_STATE_CONTROL  message  onto  the  Ballistics  message 
queue. 

•  Calculates  the  coordinates  of  the  southwest  comer  of  active  area  memory  by 
subtracting  half  of  the  AAM  width  from  the  simulated  vehicle's  coordinates. 

•  Pushes  a  MSG_B0_AAM_SW_CORNER  message  onto  the  Ballistics  message 
queue. 


Called  By:  init_simulation 


Routines  Called: 


GLOB 

mx_push 

printf 


Parameters:  DB_INFO  *pdbase 

Returns:  none 


2.13.4.3  siin_bal_frame_rate 

The  sim_bal_frame_rate  function  tells  Ballistics  the  current  CIG  frame  rate  by  pushing  a 
MSG_BO_CIG_FRAME_RA  i  c,  message  onio  the  Ballistics  message  queue.  This  function 
is  called  when  a  simulation  is  started. 

The  function  call  is  sim  bal  frame  rate(). 


Called  By:  init_simulation 


Routines  Called:  GLOB 

mx_push 


Parameters:  none 


Returns:  none 


2.13.4.4  sim_baI_req_pt_info 

The  sim_bal_req_pt_info  function  processes  the  MSG_REQUEST_POINT_INFO 
message.  This  message  is  sent  by  ^e  Simulation  Host  to  obtain  the  terrain  characteristics 
at  a  specified  point. 
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The  function  call  is  siin_bal_req_pt_info(p_insg),  where  pjnsg  is  a  pointer  to  the 
MSG_REQUEST_P0INT_INF0  message.  The  function  does  the  following: 

•  Builds  the  chord  data  required  by  Ballistics.  The  chord's  starting  x  and  y 
coordinates  are  taken  from  the  message  from  the  Simulation  Host.  The  function 
sets  the  starting  and  ending  z  coordinates  to  20000  and  -1,  respectively.  The  type 
and  id  are  set  to  GETZ_CHORD. 

•  Pushes  a  MSG_B0_TRAJ_CHORD  message  onto  the  Ballistics  message  queue. 


Called  By:  process_a_msg 


Routines  Called:  GLOB 

mx_push 


Parameters:  MSG_REQUEST_P01NT_INFO  *p_msg 


Returns:  none 


2.13.4.5  sim_bal_agl_wanted 

The  sim_bal_agl_wanted  function  sends  a  MSG_BO_TRAJ_CHORD  message  to  Ballistics 
to  (1)  calculate  the  simulated  vehicle's  altitude  above  ground  level  (AGL),  and  (2)  calculate 
the  collision  chord  for  the  simulated  vehicle,  based  on  how  far  and  in  which  direction  it  has 
moved  since  the  last  frame.  This  function  also  sends  new  frame  information  (frame  count 
and  the  current  state  of  all  dynamic  models)  to  Ballistics.  This  function  is  called  at  the  end 
of  every  frame. 

The  function  call  is  sim_bal_agl_wanted(pdynl),  where  pdynl  is  a  pointer  to  the 
structure  containing  the  current  state  of  all  dynamic  models.  The  function  does  the 
following: 

•  If  AGL  processing  is  enabled  and  the  frame  count  is  greater  than  4: 

Sets  the  trajectory  chord  id  and  type  to  AGL_CHORD. 

Sets  the  chord's  beginning  and  ending  x  and  y  coordinates  to  the  simulated 
vehicle's  current  x  and  y  coordinates. 

Sets  the  chord's  beginning  z  coordinate  to  the  simulated  vehicle's  current  z 
coordinate. 

-  Sets  the  chord's  ending  z  coordinate  to  - 1 .0. 

Pushes  a  MSG_B0_T^J_CHORD  message  onto  the  Ballistics  message 
queue. 

Sets  the  trajectory  chord  id  and  type  to  COL_CHORD. 

Sets  the  chord's  beginning  x,  y,  and  z  coordinates  to  the  simulated  vehicle's 
current  coordinates. 

Sets  the  chord's  ending  x,  y,  and  z  coordinates  to  2  times  the  simulated 
vehicle's  current  coordinate  minus  its  previous  position.  (This  is  the 
location  the  vehicle  will  occupy  in  the  next  frame  if  it  moves  in  the  same 
direction  and  the  same  distance  it  moved  in  the  last  frame.) 

Pushes  a  MSG_B0_TRAJ_CHORD  message  onto  the  Ballistics  message 
queue. 
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Sets  the  simulated  vehicle's  previous  position  to  its  new  current  position. 
•  Passes  the  new  frame  count  and  the  state  of  all  dynamic  models  to  Ballistics  by 
pushing  a  MSG_BO_NEW_FRAME  message  onto  the  Ballistics  message  queue. 


Called  By: 

msg_end 

Routines  Called: 

GLOB 

mx_push 

Parameters: 

INT_4 

Returns: 

none 

2.13.4.6  siin_bal_process_msg 

The  sim_bal_process_msg  function  is  responsible  for  processing  the  messages  that  are 
returned  to  the  real-time  software  from  Ballistics.  This  function  is  called  at  the  end  of  ever>' 
frame,  to  generate  the  messages  to  be  returned  to  the  Simulation  Host  in  the  next  exchange 
packet. 

The  function  call  is  sim_bal_process_msg().  The  function  does  the  following: 

•  Resets  the  count  of  terrain  feedback  points  to  zero. 

•  Previews  and  processes  the  top  message  in  the  Ballistics  message  queue. 

•  Deletes  that  message  from  the  queue  and  previews  the  next. 

The  following  table  identifies  the  messages  processed  by  sim_bal_process_msg,  and 
summarizes  the  processing  performed  for  each  one.  The  SEND_TF_INFO  macro 
referenced  in  the  table  is  described  in  Appendix  B. 
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Message 

Processing  by  sim  bal  process  msg 

MSG  B1  HIT  RETURN 

AGL  CHORD 

COL  CHORD 

GETZ.CHORD 

default 

Reports  an  intersection. 

Sets  the  vehicle's  altitude  to  its  z  coordinate. 

Sets  the  vehicle's  altitude  to  -9999. 

Builds  a  MSG_RETURN_PT_INFO  message  with  the 
intersection  point  data  provided  by  BaUistics. 

Builds  a  MSG_H1T_RETURN  message  with  the  data 
provided  by  Ballistics. 

MSG  B1  MISS 

AGL  CHORD 

COL  CHORD 

GETZ_CHORD 

default 

Reports  a  miss. 

Sets  the  vehicle's  altitude  to  minus  its  z  coordinate. 

No  action. 

No  action. 

Builds  a  MSG_MISS  message  with  the  data  provided  by 
Ballistics. 

MSG_B  l_SHOT_REPORT 

Reports  on  rounds  designated  for  specific  targets. 

Builds  a  MSG_SHOT_REPORT  message. 

MSG_B1_TF_HDR 

Terrain  feedback  header  message. 

Uses  the  SEND_TF_INFO  macro  to  build  a 
MSG_TF_HDR  message. 

msg_bltf_pt 

Reports  terrain  feedback  for  a  specified  point. 

Uses  the  SENT)_TF_INFO  macro  to  build  one 
MSG_TF_PT  message  for  each  feedback  point  specified 
in  the  header  message. 

Called  By: 

msg_end 

Routines  Called: 

CLOB 

mx_peek 

mx_skip 

printf 

SEND_TF_INFO 

Parameters: 

none 

Returns: 

none 

2.13.4.7  siin_baI_process_tracer 

The  sim_bal_pticx:ess_tracer  function  processes  tracer  (round  position)  messages  returned 
by  Ballistics.  This  function  is  called  at  the  end  of  every  frame. 

The  function  call  is  sim_baI_process_tracer(db,  pdbase),  where: 

db  is  the  current  double-buffer  pointer 

pdbase  is  a  pointer  to  the  primary  database  control  block 

sim_bal_process_tracer  does  the  following: 
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•  Previews  the  top  message  in  the  Ballistics  message  queue. 

•  If  the  message  is  a  MSG_Bl_ROUND_POSmON  message: 

-  Verifies  there  is  room  for  the  tracer  data. 

-  Calls  ball_effect_add  to  store  the  effects  data  in  memory  for  incorporating  in 
the  scene  with  other  effects. 

If  separate  updating  is  enabled  for  AAM2,  calls  ball_effect_add  to  store  the 
effects  data  in  menwry  for  that  AAM. 

•  Deletes  this  message  from  the  queue  and  previews  the  next  one. 


Called  By:  msg_end 


Routines  Called:  ball_effect_add 

GLOB 

mx_peek 

mx_skip 

printf 


Parameters:  INT_4 

DB  INFO 


db 

*pdbase 


Returns:  none 


2.13.4.8  sim_bal_traj_chord 

The  sim_bal_traj_chord  function  sends  the  MSG_B0_TRAJ_CHORD  message  to  Ballistics 
to  compute  the  intersection  of  a  specified  trajectory  chord.  This  function  is  called  when  the 
Simulation  Host  sends  a  MSG_'niAJ_CHORD  message. 

The  function  call  is  sim_baI_traj_chord(db,  pdbase),  where: 

db  is  the  current  double-buffer  pointer 

pdbase  is  a  pointer  to  the  primary  database  control  block 

sim_bal_traj_chord  does  the  following: 

•  Pushes  a  MSG_BO_TRAJ_CHORD  message  onto  the  Ballistics  message  queue. 

•  If  the  message  requests  tracer  effects  and  there  is  room  for  the  effects  data,  calls 
ball_effect_add  to  store  the  effects  data  in  memory  for  incorporating  in  the  scene 
with  other  effects. 

•  If  separate  updating  is  enabled  for  AAM2,  calls  ball_effect_add  to  store  the  effects 
data  in  memory  for  that  AAM. 


Called  By:  process_a_msg 


Routines  Called: 


ball_effect_add 

GLOB 

mx_push 
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db 

♦pdbase 

Returns:  none 


Parameters:  INT_4 

DB  INFO 


2.13.4.9  sim_bal_round_fired 

The  sim_bal_round_fired  function  pushes  a  MSG_BO_ROUND_FIRED  message  onto  the 
Ballistics  message  queue. 

The  function  call  is  sim_baI_round_fired(msg_P),  where  msg  P  is  a  pointer  to  the 
MSG_BO_ROUND_FIRED  messager 

This  function  is  not  currently  used.  When  it  receives  a  MSG_ROUND_FIRED  message 
from  the  Simulation  Host,  process_a_msg  pushes  the  message  onto  the  Ballistics  queue 
itself. 


Called  By:  none 

Routines  Called:  GLOB 

mx_push 

Parameters:  MSG_ROUND_FIRED  *msg_P 

Returns:  none 


2.13.4.10  sim_bal_static_add 

The  sim_bal_static_add  function  notifies  BaUistics  when  the  Simulation  Host  adds  a  static 
vehicle  to  active  area  memory  via  a  MSG_STATICVEH_STATE  message. 

The  function  call  is  sim_bal_static_add(to,  from,  type,  rent,  veh_is_tank), 
where: 

to  is  a  pointer  to  the  static  vehicle's  entry  in  the  database 

from  is  a  pointer  to  the  MSG_STATICVEH_STATE  message 

type  is  the  type  of  vehicle  (taken  from  the  message) 

rent  is  a  register  counter  used  to  store  the  vehicle’s  load  module 

veh  is  jank  indicates  whether  the  vehicle  is  a  tank  (taken  from  the  message) 

sim_bal_static_add  builds  a  MSG_BO_ADD_STATIC_VEHICLE  message,  then  pushes  it 
onto  the  Ballistics  message  queue. 


Called  By:  staticveh_state 
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Routines  Called: 

GLOB 

mx_error 

mx_push 

printf 

Parameters: 

INT  4 

*to 

INT  4 

*fTom 

INT  2 

type 

INT  2 

rent 

BYTE 

veh_is_tank 

Returns: 

none 

2.13.4.11  sini_bal_static_rein 

The  sim_bal_static_rem  function  notifies  Ballistics  when  the  Simulation  Host  deletes  a 
static  vehicle  from  active  area  memory  via  a  MSG_STATICVEH_REM  message. 

The  function  call  is  sim_bal_static_rem(from,  rent),  where: 

from  is  a  pointer  to  the  MSG_STATICVEH_REM  message 
rcra  is  a  register  counter  used  to  store  the  vehicle’s  load  module 

sim_bal_static_rem  builds  a  MSG_BO_DELETE_STATIC_VEHICLE  message,  then 
pushes  it  onto  the  Ballistics  message  queue. 


Called  By:  staticveh_remove 


Routines  Called:  GLOB 

mx_error 

mx_push 

printf 


Parameters:  INT_4  *lTom 

INT_2  rent 


Returns:  none 


2.13.4.12  siin_bal_reset 

The  sim_baLreset  function  tells  Ballistics  to  reinitialize  itself  by  pushing  a 
MSG_B0_STATE_CONTROL  message  onto  the  Ballistics  message  queue  with  the  new 
state  set  to  BX_RESET.  This  function  is  called  when  the  Simulation  Host  sends  a 
MSG_CIG_CTL  -  C_STOP  message  to  stop  the  simulation. 
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The  function  call  is  siin_bal_reset(). 

Called  By:  msg_cig_ctl 

Routines  Called:  GLOB 

mx_push 

Parameters:  none 


Returns:  none 


2.13.4.13  sim_bal_tf_veh_update 

The  sim_bal_tf_veh_update  function  notifies  Ballistics  of  the  new  position  of  the  simulated 
vehicle,  for  the  purposes  of  terrain  feedback  reporting.  This  function  is  called  whenever 
the  simulated  vehicle's  current  position  is  updated. 

This  function  is  called  only  if  the  terrain  feedback  vehicle  is  the  simulated  vehicle.  The 
Simulation  Host  may  send  MSG_TF_VEHICLE_POS  messages  to  update  the  positions  of 
other  vehicles  for  which  Ballistics  is  collecting  terrain  feedback  data.  Such  messages  are 
pushed  onto  the  Ballistics  message  queue  by  process_a_msg. 

The  function  call  is  sim_bal_tf_veh_update(time_stamp,  pos,  matrix),  where: 

time  stamp  is  the  time  stamped  in  the  MSG_TF_VEHICLE_POS  message 

pos  is  the  simulated  vehicle's  new  position 

matrix  is  the  simulated  vehicle's  new  rotation  matrix 

sim_bal_tf_veh_update  does  the  following: 

•  Determines  whether  Ballistics  needs  to  process  terrain  feedback  for  this  vehicle 
during  this  frame. 

•  Builds  a  MSG_BO_TF_VEHICLE_POS  message  with  the  data  from  the  message. 

•  Pushes  the  message  onto  the  Ballistics  message  queue. 

The  function  always  returns  0. 


Called  By:  process_vppos 


Routines  Called:  GLOB 

mx_push 


Parameters: 


UNS_2 

R4P3D 

RTS4x3_MTX 


time_stamp 

*pos 

*matrix 


454 


BBN  Systems  and  Technologies 


GTIOORTSW  CSCI 


Returns:  0 


2.13.5  ball_effect_add.c 

The  ball_effect_add  function  adds  single-frame  special  effects  to  the  current  effects  list. 
This  function  is  called  by  the  routines  responsible  for  processing 
MSG_ROUND_POSrnON  and  MSG_'ITRAJ_CHORD  messages. 

The  function  call  is  ball_effect_add(db,  type,  x,  y,  2,  pdbase,  vme_offset), 
where: 

db  is  the  double  buffer  to  be  updated 
type  is  the  type  of  special  effect 

X,  y,  and  z  are  the  world  coordinates  at  which  the  effect  is  to  be  shown 
pdbase  is  a  pointer  to  the  primary  database  control  block 
vme  offset  is  the  VME  address  offset  to  active  area  memory 

ball_effect_add  does  the  following: 

•  Uses  the  FIND_LM  macro  (described  in  Appendix  B)  to  find  the  load  module  on 
which  to  place  the  Ballistics  tracer. 

•  Puts  the  data  in  the  register  used  to  store  effects.  This  data  includes  the  effect's 
coordinates,  number  of  stamps,  number  of  frames,  and  load  module  number. 


Called  By: 


sim_bal_prcKess_tracer 

sim_bal_traj_chord 


Routines  Called:  FIND_LM 


Parameters: 


INT_4 

INT_2 

REAL_4 

REAL_4 

REAL_4 

DB.INFO 

INT  4 


db 

type 

X 

y 

z 

*pdbase 

vme_offset 


Returns:  none 


2.13.6  cal.c 

The  cal  (calibration  menu)  function  exercises  the  video  monitors  by  placing  a  known 
pattern  on  all  channels.  This  function  is  called  when  the  Gossip  user  selects  the  1 
("calibration  menu")  option  from  the  Gossip  main  menu,  cal  presents  a  menu  that  lets  the 
user  turn  the  calibration  image  or  gunner  pixel  overlay  on  or  off.  The  user  is  then  able  to 
verify  the  accuracy  of  the  image  and  take  appropriate  measures. 
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The  function  call  is  cal().  cal  displays  the  "Calibration  menu  — >"  prompt  and  uses 
unbf_getchar  to  get  the  user's  entty. 

The  following  table  identifies  the  options  presented  on  the  calibration  menu,  and 
summarizes  Ae  steps  performed  by  cal  to  process  each  selection.  The  menu  is  displayed  if 
the  user  enters  an  inv^d  character. 


Calibration  Menu  Option 

Processing  by  cal 

0  calilxation  images  off 

Sets  pcal_flag  to  FALSE  in  both  AAMs. 

1  offset  calibration  images  on 

Calls  make_cal_matrices  and  make_cal_pattems  to 
create  and  display  the  offset  calibration  overlay.  If 

AAM2  is  present,  copies  the  overlay  there. 

2  color  calibration  pixels  on 

Calls  make_cal_matrices  and  gos_polys  to  create  and 
display  the  color  calibration  pixels.  If  AAM2  is 
present,  copies  the  overlay  there. 

3  bbn  logo  on 

Calls  make_cal_matrices  and  make_bbn_logo  to  create 
and  display  the  BBN  logo  overlay.  If  AAM2  is  present, 
copies  the  overlay  there. 

5  calibration  pixels  on 

Calls  backend_get_object_addr  to  get  the  address  of  each 
backend.  For  a  T  backend,  sets  the  pixel  state  to  TRUE 
and  calls  msg  ppm  pixel  state. 

6  calibration  pixels  off 

Calls  backend _get_object_addr  to  get  the  address  of  each 
backend.  For  a  T  backend,  sets  the  pixel  state  to 

FALSE  and  calls  msg_ppm_pixel_state. 

X  exit 

Exits. 

Called  By:  gossip_tick 


Routines  Called:  backend_get_object_addr 

bcopy 

GLOB 

gos_polys 

niake_bbn_logo 

make_cal_matrices 

make_cal_pattems 

msg_ppm_pixel_state 

printf 

unbf_getchar 

VME_TO_VMX 


Parameters:  none 


Returns:  none 
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2.13.7  cigsiinio_obj.c 

The  functions  in  the  cigsiniio_obj.c  CSU  accommodate  writing  CIG-to-SEM  and  SIM-to- 
CIG  messages  to  a  binary  disk  file  (cigsimio.OOO)  during  runtime.  This  option,  called 
recording,  can  be  enabled  using  the  r  ("record  i/f  messages  menu")  option  on  the  Gossip 
main  menu.  The  user  can  open  or  close  the  record  file,  start  or  stop  recording,  and  set  Ae 
number  of  frames  to  be  recorded.  Messages  can  be  recorded  during  any  CIG  state, 
including  simulation. 

K  recording  is  enabled,  the  cigsimio_obj  functions  write  e\>ery  message  each  frame  into  a 
temporary  buffer.  Incoming  messages  are  written  to  the  buffer  as  they  are  received. 
Outgoing  messages  are  written  to  the  buffer  when  the  packet  is  sent  At  the  same  time,  the 
contents  of  the  buffer  are  written  to  a  disk  file  (cigsimio.OOO). 

The  record  file  can  be  played  back  to  repeat  the  recorded  simulation  exercise.  This  feature, 
called  absolute  script  playback,  is  available  through  options  on  the  Flea  Script  menu.  Refer 
to  section  2.7.19  for  details. 

In  addition  to  (or  instead  of)  writing  messages  to  a  disk  file,  messages  can  be  sent  to  stdout 
each  frame.  This  feature,  called  debug  message  display,  is  provided  by  the  Host  Interface 
debug  routines.  The  Host  Interface  debug  routines  are  dependent  upon  the  cigsimio_obj 
functions,  in  that  they  display  messages  from  the  temporary  buffer  created  by  the 
cigsimio_obj  functions.  This  interface  works  as  follows: 

•  The  recording  and  debug  display  features  can  be  enabled  through  Gossip.  The  user 
can  also  select  which  message  types  are  to  be  displayed. 

•  Each  frame,  the  cigsimio_write  function  copies  the  messages  to  a  temporary  buffer. 
If  message  recording  is  enabled,  cigsimio_write  writes  the  buffer  contents  to  disk 
also.  If  only  debug  display  is  enabled,  the  messages  are  written  to  the  buffer  only. 

•  At  the  end  of  each  frame,  the  host_if_debug  function  waits  for  a  mailbox  message 
to  be  posted  by  cigsimio_write.  It  then  gets  a  pointer  to  the  cigsimio  buffer  and 
calls  host_if_debug_tick  to  display  the  messages  using  the  print_msg_*  functions. 
Only  those  messages  that  have  been  enabled  for  debug  display  are  displayed;  other 
messages  in  the  buffer  are  ignored. 

•  The  cigsimio  buffer  is  initialized  at  the  beginning  of  every  frame. 

The  cigsimio_obj  functions  use  ifx_write  to  write  the  messages  to  the  binary  disk  file.  The 
print_msg_*  functions  that  write  the  messages  to  stdout  are  tailored  for  each  message  type 
to  provide  formatted,  readable  displays. 

For  more  information  on  debug  message  display,  refer  to  the  Host  Interface  Manager  CSC. 
For  more  information  on  the  specialize  print_msg_*  functions,  refer  to  the  Message 
Processing  CSC. 

The  functions  in  the  cigsimio_obj.c  CSU  are: 

•  gos_cigsimio 

•  cigsimio_msg_in 

•  cigsimio_msg_out 
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•  cigsimio_write 

•  cigsimio_get_data 

•  cigsimio_buffer_init 

•  cigsiiiiio_fraine_end 


2.13.7.1  gos_cigsiinio 

The  gos_cigsimio  function  lets  the  Gossip  user  control  the  process  of  writing  all  messages 
to  a  ^sk  file.  This  function  is  called  if  the  user  selects  the  r  ("record  i/f  messages  menu") 
option  from  the  Gossip  main  menu. 

The  function  call  is  gos_cigsimio().  gos_cigsimio  displays  a  menu  of  options,  and  uses 
unbf_getchar  to  get  the  Ireysiroke  entei^  by  Ae  user.  TTie  following  table  identifies  these 
options  and  lists  the  major  steps  performed  by  gos_cigsimio  to  process  each  selection. 


Record  I/F  Messages  Menu 
Option 

Processing  by  gos_cigsimio 

?  print  this  menu 

Displays  the  list  of  valid  options. 

b  begin  recording 

Verifies  that  the  parameters  have  been  initialized;  sets 
cigsimio_fIag  to  TRUE. 

c  close  record  file 

If  cigsimio_open_flag  is  TRUE,  sets  cigsimio_flag  and 
cigsimio_open_flag  to  FALSE;  calls  ifx_close  to  close 
the  file. 

If  cigsimio_open_flag  is  FALSE,  displays  an  error. 

e  end  recording 

If  cigsimio_flag  is  TRUE,  sets  cigsimio_close_flag  to 
TRUE;  if  not,  outputs  an  error. 

f  #  frames  written 

Displays  the  number  of  frames  written,  maximum 
number  of  frames,  and  number  of  bytes  written. 

i  initialize 

Prompts  the  user  for  the  file  name;  sets  cigsimio_fn; 
initializes  the  frame  and  byte  count  parameters;  sets 
cigsimio_init_flag  to  TRUE. 

m  change  frames  to  record 

Prompts  the  user  for  the  number  of  frames  to  record; 
sets  max_num_io_frames  to  the  user's  entry  or  to  a 
default  value  if  the  entry  exceeds  the  maximum  allowed. 

0  open  record  file 

Calls  ifx_open  to  create  and  open  the  file;  sets 
cigsimio_open_flag  to  TRUE. 

q  quit 

Exits. 

s  write  string  to  file 

Prompts  the  user  for  the  tag  string;  calls  cigsimio_write 
to  write  the  string  to  the  file. 

X  exit 

Exits. 

Called  By:  gossip_tick 


Routines  Called:  cigsimio_write 

ifx_close 

ifx_open 
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printf 

scanf 

strlen 

unbf_getchar 


Parameters:  none 

Returns:  none 


2.13.7.2  cigsimio_msg_in 

The  cigsimio_msg_in  function  determines  whether  or  not  an  incoming  message  should  be 
written  to  the  cigsimio  buffer.  This  function  is  called  every  time  a  message  is  read  from  an 
incoming  exchange  packet 

The  function  call  is  cigsimio_msg_in(p_addr,  byte_count,  frame_flag),  where: 

p  addr  is  a  pointer  to  the  incoming  message 
byte  count  is  the  number  of  bytes  in  the  message 
frame  Jlag  is  «TBD» 

cigsimio_msg_in  first  determines  whether  message  recording  or  debug  message  display 
has  been  enabled  through  Gossip  (i.e.,  if  either  cigsimio_flag  or  cigsimio_log_request  is 
TRUE).  If  so,  it  calls  cigsimio_write  to  copy  the  message  to  the  buffer  and,  if  recording  is 
enabled,  to  write  it  to  the  disk  file.  The  message  is  tagged  TAG_MSG_TO_CIG. 


Called  By: 

cig_config 

db_mcc_setup 

file_control 

get_msg_2d 

hw_test 

process_a_msg 

upstart 

Routines  Called: 

cigsimio_write 

Parameters: 

UNS  4 

*p_addr 

INT  4 

byte_count 

BOOLEAN 

fi^e_flag 

Returns: 

none 

2.13.7.3  cigsimio_msg_out 

The  cigsimio_msg_out  function  determines  whether  or  not  an  outgoing  message  packet 
should  be  written  to  the  cigsimio  buffer.  During  a  simulation,  this  function  is  called  at  the 
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end  of  each  frame.  During  other  states,  it  is  called  whenever  a  MSG_END  message  is 
received  from  the  Simulation  Host,  indicating  the  end  of  a  message  packet. 

The  function  call  is  cigsiinio_msg_out(p_addr,  byte_count,  frame_nag),  where: 

p  addr  is  a  pointer  to  the  message  packet 
byte  count  is  the  number  of  bytes  in  the  packet 
frame  Jlag  'xs  «TBD» 

cigsimio_msg_out  first  determines  whether  message  recording  or  debug  message  display 
has  been  enabled  through  Gossip  (i.e.,  if  either  cigsimio_flag  or  cigsimio_log_request  is 
TRUE).  If  so,  it  calls  cigsimio_write  to  copy  the  messages  to  the  buffer  and,  if  recording 
is  enabled,  to  write  them  to  the  disk  file.  The  message  packet  is  tagged 
TAG_MSG_TO_CIG. 


Called  By:  _set_up_for_next_frame 

cig_config 

db_mcc_setup 

file_control 

get_msg_2d 

hw_test 

upstart 


Routines  Called:  cigsimio_write 


Parameters: 


UNS_4 

INT_4 

BOOLEAN 


*p_addr 

byte_co’int 

frame_flag 


Returns:  none 


2.13.7.4  cigsimio_write 

The  cigsimio_write  function  writes  incoming  and  outgoing  messages  to  a  temporary  buffer 
and,  if  recording  is  enabled,  to  a  file  on  disk.  This  function  is  called  every  time  a  message 
is  received  or  a  message  packet  is  sent,  but  only  if  message  recording  ancVor  debug 
message  display  has  been  enabled  through  Gossip. 

cigsimio_write  also  manages  the  record  file.  For  example,  it  closes  the  file  if  it  reaches  its 
maximum  size  or  the  specified  number  of  frames,  and  opens  or  closes  the  file  per  the  user's 
request  through  Gossip. 

The  function  call  is  cigsiinio_wrUe(p  addr,  byte  count,  franie_flag, 
record_tag),  where: 

p  addr  is  a  pointer  to  the  message  or  packet  to  be  written 
byte  count  is  the  number  of  bytes  to  be  written 
frame  Jlag  is  <<TBD» 

record  jag  identifies  the  type  of  message:  CIG-to-SIM  or  SIM-to-ClG 
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cigsimio_write  does  the  following: 

•  If  the  Gossip  user  has  requested  that  the  record  file  be  closed: 

-  Sets  cigsimio_close_flag  and  cigsimio_open_flag  to  FALSE. 

-  Calls  ifx_close  to  close  the  record  file. 

-  Sets  cigsiinio_flag  to  FALSE. 

•  If  the  record  file  has  reached  its  maximum  size: 

-  Disables  recording  by  setting  cigsimio_flag  to  FALSE. 

-  Calls  ifx_close  to  close  the  record  file. 

-  Sets  cigsimio_open_flag  to  FALSE. 

•  If  the  record  file  is  not  open: 

-  Calls  ifx_open  to  open  the  file. 

Sets  cigsimio_open_flag  to  TRUE. 

•  Creates  a  new  tag  record  (specifying  the  number  of  frames  written,  current  time, 
and  byte  count)  and  copies  it  to  the  cigsimio  buffer. 

•  Copies  the  message(s)  to  the  cigsimio  buffer. 

•  If  recording  is  enabled  and  either  frame_flag  is  TRUE  or  the  record  tag  is 
TAG_MSG_FROM_CIG: 

-  Writes  the  messages  from  the  buffer  to  the  record  file  on  disk. 

-  Increments  the  number  of  frames  written. 

-  If  the  maximum  number  of  frames  has  been  written,  closes  the  record  file 
and  turns  recording  off. 


Called  By: 

cigsimio_msgJn 

cigsimio_msg_out 

gos_cigsimio 

Routines  Called: 

bcopy 

ifx_close 

ifx_open 

ifx_write 

read_watch 

Parameters: 

UNS  4 

*p_addr 

INT  4 

byte_count 

BOOLEAN 

ft^e_flag 

UNS_1 

record_tag 

Returns: 

none 

2.13.7.5  cigsiniio_get_data 

The  cigsimio_get_data  function  returns  a  pointer  to  the  cigsimio  buffer.  This  function  is 
called  when  the  Host  Interface  debug  display  routines  are  ready  to  print  the  buffered 
messages  to  stdout. 

The  function  call  is  cigsimio_get_data(pkMen),  where  pkt  len  is  a  pointer  for  the  size 
of  the  buffer. 
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cigsimio_get_data  returns  a  pointer  to  the  buffer  and  places  the  buffer  size  in  the  location 
specified  by  pktjen. 

Called  By:  host_if_debug 

Routines  Called:  none 

Parameters:  INT_4  ♦pktjen 

Returns:  ♦todisk_buffer 

2.13.7.6  cigsimio_buffer_init 

The  cigsimio_buffer_init  function  initializes  the  cigsimio  buffer  and  sets  the 
cigsimio_log_request  variable  to  TRUE  (indicating  that  debug  display  is  enabled).  This 
function  is  called  at  the  beginning  of  every  frame,  to  clear  the  buffer  for  the  new  messages 
from  the  current  frame. 

The  function  call  is  cigsimio_bufferJnit(). 

Called  By  ;  host_if_debug 

Routines  Called:  none 

Parameters;  none 

Returns;  none 

2.13.7.7  cigsimio_frame_end 

The  cigsimio_frame_end  function  sets  the  cigsimio_log_request  variable  to  FALSE,  then 
posts  a  message  to  the  cigsimio_complete  mailbox.  This  message  tells  host_if_debug  that 
all  messages  fiiom  the  previous  frame  have  been  written  to  the  cigsimio  buffer  and  are  ready 
to  be  processed  by  host_if_debug_tick.  This  function  is  called  at  the  end  of  every  frame. 

The  function  call  is  cigsimio_frame_end(). 

Called  By:  msg_end 

Routines  Called:  sc_post 
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Parameters;  none 

Returns:  none 


2.13.8  cIose_db.c 

The  close_db  function  closes  and  frees  all  database  information,  including  names,  headers, 
model  address  tables,  and  catalog  tables.  It  also  closes  the  terrain  database  and  the  DED 
file.  This  function  is  called  when  the  Simulation  Host  sends  a  CIG  Control-Stop  message 
to  end  the  simulation. 

The  function  call  is  cIose_db().  If  the  system  contains  multiple  backends,  close_db  frees 
and  closes  the  database  in  each  one. 


Called  By; 

msg_cig_ctl 

Routines  Called: 

free 

XCLOSE 

Parameters: 

none 

Returns: 

none 

2.13.9  clouds. c 

The  functions  in  the  clouds.c  CSU  activate  and  manage  cloud  models.  These  functions  are; 

•  cloudjnit 

•  cloud_update 

•  cloud_update_model 

•  cloud_mgmt 

•  cloud_placement 

•  cloud_scud 

•  set_lut 

•  md 


2.13.9.1  cloudjnit 

The  cloud_init  function  sets  up  and  initializes  the  cloud  model  and  the  cloud  control 
structure.  This  function  is  called  at  viewport  configuration  time. 

The  function  call  is  cloud  init(type),  where  type  is  the  type  of  cloud  model: 
CLOUD_TOP  or  CLOUT)_BOT.  cloud_init  does  the  following: 

•  Allocates  and  initializes  the  model  call. 
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•  Allocates  and  sets  up  the  cloud  control  structure. 


Called  By  : 

cig_config 

Routines  Called: 

aam  malloc 

GLOB 

INIT_MTX 

Parameters: 

WORD 

Returns: 

none 

2.13.9.2  cloud_update 

The  cloud_update  function  updates  cloud  parameters.  This  function  is  called  when  the 
Simulation  Host  sends  a  MSG_CLOUD_STATE  message,  which  specifies  the  cloud  top 
and  bottom  models  and  positions  them  at  the  desired  altitudes. 

The  function  call  is  cloud_update(pmsg),  where  pmsg  is  a  pointer  to  the 
MSG_CLOUD_STATE  message.  cloud_update  does  the  following: 

♦  If  the  cloud  state  in  the  message  is  FALSE  (0): 

-  Sets  clouds_wanted_G  to  FALSE. 

-  Turns  off  the  cloud  models. 

If  AAM2  exists,  disables  cloud  processing  there  also. 

Sets  cloud_state  to  NULL. 

•  If  the  cloud  state  in  the  message  is  TRUE  (1): 

-  Validates  the  data  in  the  message: 

*  If  the  cloud  bottom  in  the  message  is  below  the  top,  sets  the  bottom 
equal  to  the  top. 

*  If  scud  processing  is  enabled  and  the  scud  top  and  bottom  are  not 
outside  the  cloud  top  and  bottom,  sets  the  scud  bottom  to  5.0  meters 
below  the  cloud  bottom,  and  sets  the  scud  top  to  5.0  meters  above 
the  cloud  top. 

Sets  the  new  cloud  (and  scud)  top  and  calls  cloud_update_model  to  set  the 
model's  address. 

-  Sets  the  new  cloud  (and  scud)  bottom  and  calls  cloud_update_model  to  set 
the  model's  address. 

Sets  the  scud  top  and  bottom  thickness  parameters  (the  distance  from  the 
scud  top  to  the  cloud  top  and  from  the  scud  bottom  to  the  cloud  bottom). 

-  Sets  new_cloud_data  to  TRUE.  This  triggers  cloud_mgmt  to  process  the 
changes. 


Called  By:  process_a_msg 

Routines  Called:  AAM2_ADDR 

cloud_update_model 
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GLOB 

Parameters:  MSG_CLOUD_STATE  *pmsfe 

Returns:  none 


2.13.9.3  cloud_update_modeI 

The  cloud_update_model  function  sets  up  a  cloud  model’s  address. 

The  function  call  is  cloud_update_model(type,  modeI_id),  where: 

type  is  CLOUD_TOP  or  CLOUD_BOT 

model Jd  is  the  model  id  from  the  Simulation  Host  message 

cloud_update_model  gets  the  model's  address  from  the  DED  model  address  table,  then  puts 
the  model's  address  into  the  cloud  control  structure.  If  the  system  contains  two  backends, 
cloud_update_model  updates  both  databases. 


Called  By: 

cloud_update 

Routines  Called: 

printf 

Parameters: 

WORD 

HWORD 

Returns: 

none 

type 

modeljd 


2.13.9.4  cloud_mgmt 

The  cloud_mgmt  function  manages  cloud  placement  and  effects.  This  function  is  called  at 
the  end  of  every  frame  to  process  the  changes  requested  during  that  frame. 

The  function  call  is  cloud_mgmt().  cloud_mgmt  does  the  following: 

•  If  the  cloud  has  changed  altitude  (i.e.,  new_cloud_data  is  TRUE): 

-  Sets  new_cloud_data  to  FALSE. 

-  Updates  the  top  and  bottom  models'  information. 

•  If  the  simulated  vehicle  is  now  below  the  clouds: 

-  Sets  the  cloud  state  to  BELOW_CLOUDS. 

-  Turns  on  the  cloud  bottom  model. 

-  If  AAM2  is  present,  turns  on  the  cloud  bottom  model  there  also. 

-  If  the  simulated  vehicle  is  now  in  the  bottom  scud  layer,  calculates  the  scud 
ratio  and  calls  cloud_scud. 

-  If  the  vehicle  is  not  in  the  bottom  scud  layer,  calls  cloud_scud  with  the  scud 
ratio  set  to  NO_SCUD. 
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-  Calls  cloud_placement  to  update  the  model's  position. 

•  If  the  simulated  vehicle  is  now  above  the  clouds; 

-  Sets  the  cloud  state  to  ABOVE_CLOlJDS. 

-  Turns  on  the  cloud  top  model. 

-  If  AAM2  is  present,  turns  on  the  cloud  top  model  there  also. 

-  If  the  simulated  vehicle  is  now  in  the  top  scud  layer,  calculates  the  scud  ratio 
and  calls  cloud_scud. 

-  If  the  vehicle  is  not  in  the  top  scud  layer,  calls  cloud_scud  with  the  scud 
ratio  set  to  NO_SCUD. 

-  Calls  cloud_placement  to  update  the  model's  position. 

•  If  the  simulated  vehicle  is  now  in  the  clouds: 

-  Turns  off  the  top  or  bottom  model  (whichever  was  active,  based  on  the 
previous  cloud  state). 

If  AAM2  is  present,  turns  the  cloud  model  off  there  also. 

-  Calls  cloud_scud  with  the  scud  ratio  set  to  FULL_SCUD. 

-  Sets  the  cloud  state  to  IN_THE_CLOlJDS. 


Called  By: 

msg_end 

Routines  Called: 

AAM2_ADDR 
cloud_placement 
cloud  scud 
GLOB 

Parameters: 

none 

Returns: 

none 

9.5  cloud_placement 

The  cloud_placement  function  updates  the  cloud  model's  position.  This  function  is  called 
to  move  the  cloud  model  to  keep  it  in  line  with  the  simulated  vehicle.  The  cloud  is  moved 
in  a  fixed  increment  (cloud_modulo)  set  in  the  clouds.h  include  file. 

The  function  call  is  cloud_placement(pcIoud),  where  pcloud  is  a  pointer  to  the  cloud's 
control  information.  ” 

cloud_placement  checks  the  simulated  vehicle's  new  position,  moves  the  cloud  model  in 
the  required  direction,  and  upxiates  the  cloud  model's  matrix  accordingly. 


Called  By:  cloud_mgmt 


Routines  Called;  GLOB 


Parameters: 


CLOUD.CONTROL 


*pcloud 
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Retimis;  none 


2.13.9.6  cIoud_scud 

The  cloud_scud  function  creates  a  scud  effect  that  depends  on  the  altitude  of  the  simulated 
vehicle  in  comparison  to  the  cloud  and  scud  layer  altitudes. 

The  function  call  is  cloud_scud(ratio),  where  ratio  is  one  of  the  following: 

•  If  the  simulated  vehicle  is  in  a  scud  layer,  the  ratio  is  the  distance  between  the 
vehicle  and  the  edge  of  the  scud  layer,  divided  by  the  thickness  of  the  scud  layer. 

•  If  the  simulated  vehicle  is  in  the  clouds,  the  ratio  is  FULL_SCUD. 

•  If  the  simulated  vehicle  is  not  in  a  scud  layer  or  in  the  clouds,  the  ratio  is 
NO_SCUD. 

cloud_scud  calls  set_lut  to  select  a  lookup  table  entry  suitable  for  the  required  scud  effect. 
If  the  ratio  is  larger  than  the  random  number  return^  by  rnd,  it  is  treated  as  FULL_SCUD. 


Called  By: 

cloud_mgmt 

Routines  Called: 

md 

set_lut 

Parameters: 

REAL_4 

Returns: 

none 

2.13.9.7  set_Iut 

The  set_lut  function  selects  an  entry  from  the  3-D  lookup  table  Gut3d)  to  display  a  scud 
effect.  The  entry  selected  is  based  on  whether  the  simulated  vehicle  is  in  the  clouds,  in  a 
scud  layer,  or  completely  above  or  below  the  clouds  and  scud  layers. 

The  function  call  is  set_lut(n,  idx),  where: 

n  is  the  backend  id  (0  or  1) 

idx  is  index  of  the  desired  lookup  table 


Called  By:  cloud_scud 


Routines  Called:  none 


Parameters:  INT_4 

INT_4 


n 

idx 
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Returns:  none 


2.13.9.8  rnd 

The  md  function  is  a  random  number  generator.  This  function  is  used  to  generate  a 
number  to  compare  to  the  scud  ratio  cadculated  when  the  simulated  vehicle  is  inside  a  scud 
layer.  If  the  ratio  exceeds  the  random  number  generated,  the  FULL_SCUD  lookup  table 
entry  is  selected. 

The  function  call  is  md(). 


Called  By:  cloud_scud 


Routines  Called:  none 


Parameters:  none 

Returns:  seed  ♦  .00000(XXX)4656613 


2.13.10  config_baUistics.c 

The  functions  in  the  config_ballistics.c  CSU  are  used  to  configure  Ballistics  and  establish 
the  communication  path  between  Ballistics  and  the  real-time  software.  These  functions  are: 

•  config_baUistics 

•  bal_buffer_setup 


2.13.10.1  config_baIlistics 

The  config_ballistics  function  reads  the  Ballistics  configuration  file  (ballist.cfg).  This  file 
specifies  whether  to  use  a  local  Ballistics  task  or  to  interface  with  a  Ballistics  process 
running  on  another  CPU.  This  function  is  called  at  initialization  time. 

The  function  call  is  config_ballistics(tte,  tid,  base_priority),  where: 

tte  is  the  Ballistics  task's  entry  in  the  task  table 
tid  is  the  task  id  assigned  to  the  Ballistics  task 
base  jjriority  is  the  task's  priority 

config_ballistics  does  the  following: 

•  Initializes  the  Ballistics  board  type  to  NO_BALLISTICS. 

•  Checks  to  see  if  Ballistics  processing  has  been  disabled  (by  specifying  the  "b" 
argument  on  the  startup  command  line).  If  so,  sets  ball_is_present  to  FALSE  and 
exits. 
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•  Sets  ball_is_present  to  TRUE. 

•  Calls  fopen  to  open  the  Ballistics  confi^ation  file. 

-  If  the  file  cannot  be  opened,  or  if  the  file  specifies  an  invalid  type,  sets  the 
Ballistics  board  type  to  MASTER147_BALLISTICS. 

-  If  the  file  specifies  Slave  Ballistics,  calls  bus_error  to  verify  that  the  Slave 
board  is  present,  then  sets  the  Ballistics  board  type  to 
SLAVE147_BALLISTICS. 

-  If  the  file  specifies  Master  Ballistics,  sets  the  Ballistics  board  type  to 
MASTER147_BALLISTICS. 

•  Calls  fclose  to  close  the  Ballistics  configuration  file. 

•  If  Master  Ballistics  is  set,  calls  pcreate  to  create  a  task  table  entry  for  the  Ballistics 
task. 

•  Pauses  (using  sc_delay)  to  give  the  task  time  to  start  up. 

•  Calls  bal_buffer_setup  to  establish  an  interface  to  the  Ballistics  task. 

•  Calls  mx_peek  to  get  the  MSG_B  1_STATUS_RETURN  returned  by  Ballistics 
after  it  initializes,  dien  discards  the  message. 

If  an  error  is  detected,  the  function  exits  with  a  1. 


Called  By:  main  (in  rtt.c) 


Routines  Called: 


bal_buffer_setup 

bus_error 

exit 

fclose 

fgets 

fopen 

GLOB 

mx_peek 

mx_skip 

pcreate 

printf 

sc_delay 

serror 

sscanf 

strcmp 


Parameters: 


struct  {int 

last; 

int 

in_use; 

int 

(*task_addr)(); 

char 

♦name; 

int 

priority_offset; 

} 

INT_4 

INT_4 


Returns: 


none 


♦tte 

tid 

base_priority 
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2.13.10.2  bal_buffer_setup 

The  bal_buffer_setup  function  establishes  the  interface  between  the  real-time  software  and 
Ballistics.  The  processes  communicate  via  the  Ballistics  message  queues,  which  are 
described  in  the  Ballistics  Processing  CSC  section. 

The  function  call  is  bal_bufTer_setup().  The  function  does  the  following: 

•  Pauses  (using  sc_delay)  to  wait  for  the  Ballistics  addresses  to  be  published. 

•  Calls  mpv_nfind  to  get  the  addresses  and  sizes  of  the  three  Ballistics  message 
queues. 

•  the  addresses  are  not  published  yet,  pauses  and  then  calls  mpv_nfind  again.  If  it 
has  10  unsuccessful  retries,  bal_buffer_setup  resets  the  Ballistics  board  type  to 
NO_BALLISTICS,  sets  b^_is_present  to  FALSE,  and  quits. 

•  Gets  the  Ballistics  queue  parameters. 

•  If  Ballistics  printiiig  is  enabled,  outputs  the  Ballistics  message  queue  parameters  to 
stdout. 

The  function  returns  TRUE  if  it  is  successful.  It  returns  FALSE  if  mpv_nfind  could  not 
find  the  Ballistics  message  queue  parameters. 


Called  By:  config_ballistics 


Routines  Called:  GLOB 

mpv_nfind 

pimtf 

sc_delay 


Parameters:  none 

Returns:  1  (TRUE) 

0  (FALSE) 


2.13.11  config_color_tabIe.c 

The  config_color_table  function  open  a  specified  color  table  file.  This  fimction  is  called 
when  the  Simulation  Host  sends  a  MSG_CIG_CrrL  -  CIG_CONFIG  message.  The  name 
of  the  file  can  be  specified  with  the  MSG_FILE_DESCR  -  DB_COLOR_CFG_0  (backend 
0)  or  DB_COLOR_CFG_l  (backend  1)  message.  The  default  file  name  is  color.cfg. 

The  color  table  file  contains  the  following: 

•  Color  offset. 

•  Color  description. 

•  3-D  lookup  table  (TX  backends  only). 

•  2-D  lookup  table  (TX  backends  only). 

•  ESIFA  color  (T  backends  only). 
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•  Minimum  acceptable  fade  value. 

•  Maximum  acceptable  fade  value. 

•  DTP  (thermal)  switching  value. 

The  function  call  is  config_color_tabIe(pfn),  where  pfn  is  a  pointer  to  the  name  of  the 
color  table  file.  config_color_table  does  the  following: 

•  Opens  the  specified  file. 

•  Gets  and  sets  the  values  for  all  normal  mode  video  registers. 

•  Gets  and  sets  the  values  for  all  optional  mode  video  registers. 

•  Gets  and  sets  the  values  for  video  on/off. 

•  Gets  and  sets  the  values  for  dtp_switching  (normal,  alternate,  and  modifier). 

•  Gets  and  sets  the  values  for  the  fade  bits  (and_sky,  or_sky,  and_laser,  and 
or_laser). 

•  Clears  the  color  descriptions  from  memory. 

•  Reads  the  color  table  and  sets  the  specified  values  in  memory. 

•  Closes  the  file. 

The  function  exits  with  a  1  if  the  specified  file  could  not  be  opened  or  the  table  contains  too 
many  entries. 


Called  By: 


db_mcc_setup 


Routines  Called:  exit 

fclose 

fgets 

fopen 

printf 

sscanf 


Parameters:  BYTE  *pfn 

Returns:  none 


2.13.12  config_database.c 

The  functions  in  the  config_database.c  CSU  open  the  database  configuration  file.  These 
functions  are: 


•  config_databasc 

•  errors 

•  func_msg 

•  print jjdbase 


2.13.12.1  config_database 

The  config_dalabase  function  opens  the  database  configuration  (database.cfg)  file  to  find 
and  set  the  names  of  the  terrain  database  and  DED  files,  local  terrain  message  parameters. 
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and  terrain  and  field-of-view  addresses.  This  function  is  called  when  the  system  is 
initialized. 

A  different  database  configuration  file  can  be  specified  with  the  MSG_FILE_DESCR  - 
DB_SETUP_0  (backend  0)  or  DB_SETUP_1  (backend  1)  message.  The  database 
configuration  file  specifies  the  following: 

•  Database  name. 

•  DED  database  name. 

•  Initial  frame  to  return  a  local  terrain  message. 

•  Number  of  frames  between  subsequent  local  terrain  messages. 

•  Terrain  address  and  field-of-view  table  address  for  each  AAM. 

The  function  call  is  config_database().  The  function  does  the  following; 

•  Initializes  the  primary  database  control  blocks. 

•  Sets  the  default  database  and  DED  file  names. 

•  Sets  up  the  VME  offsets  for  active  area  memory  in  each  backend. 

•  Sets  the  default  local  terrain  frequency. 

•  Calls  errors  to  check  for  errors. 

•  Sets  up  pointers  to  the  DATABASE_MB  mailboxes  (one  per  rowcoLrd  task). 

•  If  a  subsys.cfg  file  exists: 

-  Calls  get_database_name  to  get  the  name  of  the  database  file  for  each 
backend. 

-  Sets  the  db_to_use  variable  for  each  backend. 

-  Calls  get_ded_name  to  get  the  name  of  the  DED  file  for  each  backend. 

-  Sets  the  ded_db_to_use  variable  for  each  backend. 

-  Outputs  the  file  names  to  stdout 

-  Calls  errors  to  check  for  errors. 

•  If  no  subsys.cfg  file  is  found; 

-  Ctdls  fopen  to  open  the  database.cfg  file. 

-  If  no  database.cfg  file  is  found,  outputs  a  message  to  stdout  and  returns  a 
value  indicating  how  many  database  management  tasks  need  to  be  set  up 
(one  per  backend). 

-  If  a  database.cfg  file  is  found,  reads  the  configuration  information  (file 
names,  local  terrain  message  parameters,  AAM  terrain  address,  and  AAM 
fov  table  address)  for  each  database  (each  backend). 

-  Calls  errors  to  check  for  errors. 

-  Closes  the  database.cfg  file. 

If  no  subsy.cfg  or  database.cfg  file  was  found,  the  function  returns  1  if  one  AAM  is 
present,  or  2  if  two  AAMs  are  present.  If  a  configuration  file  was  found,  the  function 
returns  the  number  of  AAMs  as  i.  This  triggers  the  creation  of  the  correct  number  of 
rowcoLrd  tasks  (one  per  backend). 

The  function  exits  with  a  1  if  an  error  is  found. 


Called  By:  main  (in  rtt.c) 


Routines  Called: 


errors 

exit 

fclose 
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fgets 

fopen 

get_database_name 

get_ded_name 

printf 

sprintf 

sscanf 

strcpy 

strlen 


Parameters:  none 

Returns:  1 

2 

i 


2.13.12.2  errors 

The  errors  function  checks  for  the  following  errors  for  config_database: 

•  Invalid  terrain/field-of-view  table  addresses. 

•  Invalid  local  terrain  frequency  parameter. 

The  function  call  is  errors  (pdbase),  where  pdbase  is  a  pointer  to  the  primary  database 
control  block. 

The  function  returns  TRUE  if  an  error  is  found,  or  FALSE  if  the  data  is  valid. 


Called  By: 
Routines  Called: 

Parameters: 

Returns: 


config_database 

bus_error 

func_msg 

DB_INFO 

1  (TRUE) 

0  (FALSE) 


♦pdbase 


2.13.12.3  func_msg 

The  func_msg  function  outputs  the  error  "***  ERROR:  <text>:  DATABASE.CFG"  to 
stdout.  The  variable  text  is  supplied  by  the  calling  function. 

The  function  call  is  func_msg(s),  where  s  is  the  error  text  to  appear  in  the  output 
message. 
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Called  By: 

errors 

open_dbase 

Routines  Called; 

printf 

Parameters: 

BYTE 

Returns: 

none 

2.13.12.4  print_pdbase 

The  print_pdbase  function  outputs  the  contents  of  a  specified  database  configuration  file  to 
stdout.  Specifically,  it  prints  the  following; 

•  Database  identifier. 

•  Database  file  name. 

•  DED  file  name. 

•  Local  terrain  initial  fi'ame. 

•  Local  terrain  message  frequency. 

•  Terrain  address. 

•  Field-of-view  table  address. 

•  File  descriptor. 

The  function  call  is  print_pdbase(pdb),  where  pdb  is  a  pointer  to  the  primary  database 
control  block. 

This  function  is  not  currently  used. 


Called  By: 

none 

Routines  Called: 

printf 

Parameters; 

DB_INFO 

Returns: 

none 

*pdb 


2.13.13  db_mcc_setup.c 

The  db_mcc_setup  function  processes  messages  from  the  Simulation  Host  to  prepare  the 
CIG  system  to  run  a  simulation.  It  can  also  prepare  the  CIG  to  act  as  an  MCC  station, 
although  this  mode  is  not  currently  used.  db_mcc_setup  is  called  when  the  CIG  Control 
message  from  the  Simulation  Host  specifies  C_DB_SETUP  or  C_MCC_SETUP. 
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The  function  call  is  db_mcc_setup(state),  where  state  is  the  state  the  system  is  to  be  set 
up  in;  C_DB_SETUP  (simulation  mode)  or  C_MCC_SETUP  (MCC  station  mode). 

db_mcc_setup  does  the  following; 

•  Initializes  trajectory  table  static  variables. 

•  Sets  the  default  ESIFA  (textures)  file  name  if  none  has  been  specified. 

•  Sets  the  default  color  configuration  file  name  if  none  has  been  specified. 

•  Outputs  the  ESIFA  and  color  file  names  to  stdout. 

•  Calls  poll_shutdown  to  see  if  a  system  shutdown  has  been  requested. 

•  Processes  each  message  received  from  the  Simulation  Host; 

-  Verifies  that  the  packet  length  has  not  been  exceeded;  uses  SYSERR  to 
generate  a  MSG_SYS_ERROR  if  it  has. 

-  (Tails  cigsimio_msg_in  to  write  the  message  to  a  buffer  (if  message 
recording  or  debug  message  display  is  enabled). 

-  Processes  the  message  based  on  its  message  type  (see  table  below).  Uses 
SYSERR  to  generate  an  error  message  if  an  invalid  message  is  received. 

•  Returns  control  to  upstart  when  it  returns  from  cig_config  or  a  simulation,  or  when 
it  detects  a  CIG-Control  Stop  message. 

The  following  table  summarizes  the  processing  performed  by  db_mcc_setup  in  response  to 
each  valid  message  type  it  receives  from  the  Simulation  Host.  The  first  column  hsts  the 
messages  in  alphabetical  order.  The  second  column  briefly  describes  the  purpose  of  the 
message  (in  italics),  then  lists  the  major  steps  performed  by  db_mcc_setup  to  process  the 
message. 


Message  from  SIM  Host 

Processing  by  db_mcc_setup 

MSG_ADD_TRAJ_TABLE 

Adds  a  trajectory  table. 

Calls  mx_push  to  push  MSG_BO_ADD_TRAJ_TABLE 
message  onto  Ballistics  message  queue. 

MSG_AMMO_DEFINE 

Selects  ammunition  maps. 

Loads  specified  ammo  maps  into  memory. 

MSG  CIG  CTL 

C.QG.CONHG 

C  START  2D  SETUP 

C  MCC  SIMUL 

C  SIMULATION 

C  STOP 

C_NULL 

Causes  a  transition  to  another  performance  state. 

Calls  config_color_table;  calls  cig_config;  calls 
load_dbase  for  each  backend. 

Calls  cig_2d_setup. 

Calls  simulation  with  state  set  to  C_MCC_SIMUL. 

Calls  simulation  with  state  set  to  C_SIMULATION. 
Returns  to  upstart. 

No  action. 

MSG_DEFINE_TX_MODE 

Defines  viewport  switching  data  for  TX  backends. 

Calls  mpvidM_define_mode. 

MSG_DELETE_TRAJ_TABLF 

Deletes  a  trajectory  table. 

Calls  mx_push  to  push 

MSG_BO_DELETE_TRAJ_TABLE  message  onto 
Ballistics  message  queue. 

MSG_DRI1_PKT_SIZE 

Species  exchange  packet  parameters. 

Outputs  data  from  message;  sets  CIG  and  SIM  exchange 
packet  sizes;  validates  local  terrain  chunk  size  and  sets  if 
valid;  validates  local  terrain  message  interval  and  sets  if 
valid;  sets  CIG  hardware  type. 
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MSG.END 

Signals  end  of  packet  buffer. 

Calls  cigsiinio_msg_out  to  write  the  outgoing  message 
packet  to  the  cigsimio  buffer  if  receding  or  debug 
display  is  enabled;  if  ppm_message_flag  is  TRUE,  calls 
esifa_send_req  and  sets  flag  to  FALSE;  calls  the 
af^ropriate  exchange_data  routine  (through 
'*'exchange_data)  to  exchange  packets. 

MSG_FILE_DESCR 

Specifies  database  files  to  use  for  simulation. 

DB.SETUP 

If  no  database  has  been  specified,  outputs  a  message;  if 
specified,  calls  qien.dbase. 

DB  SETUP  0, 

DB_SETUP_1 

(2alls  set  database  name  for  specified  backend;  gets  and 
outputs  file  name. 

DB  DED  SETUP  0. 
DB_DED_SETUP_1 

Calls  set_ded_name  for  specified  backend;  gets  and 
outputs  file  name. 

DB  COLOR  CFG  0. 
DB_COLOR_CFG_l 

Calls  set_color_config_name  fw  both  backends;  gets 
and  outputs  file  name. 

DB  ESIFA  LOAD  0, 
DB_ESIFA_LOAD_l 

Sets  esifa_load_wanted  to  TRUE;  outputs  file  name; 
calls  set_esifa_name  and  load_esifa  for  specified 
backend. 

DB  SUBSYS  0, 

DB_SUBSYS_1 

Calls  init_subsys_parser,  opens  file;  calls 
set_token_file;  calls  parse_subsys_file;  closes  file; 
outputs  names  of  all  database  files  for  both  backends;  if 
esifa  name  is  not  set,  sets  it,  sets  esifaJoad_wanted  to 
TRUE,  and  calls  load_esifa;  sets  db_to_use  and 
ded_db_to_use  for  both  backends;  calls  mpvideojoad  to 
load  final  lookup,  3d  lookup,  and  data_2d  tables  for  both 
backends. 

DB  DATA  2D  0, 
DB_DATA_2D_1 

Calls  set_data_2d_name  for  specified  backend;  outputs 
file  name;  calls  mpvideojoad  for  specified  backend. 

DB  FINAL  LUT  0, 
DB_FINAL_LUT_1 

Calls  set_final  Jut_name  for  specified  backend;  outputs 
fde  name;  calls  mpvideojoad  for  specified  backend. 

DB  3D  LUT  0. 

DB_3D_LUT_1 

Calls  set_3djut_name  fw  specified  backend;  outputs 
file  name;  calls  mpvideojoad  for  specified  backend. 

MSG_PPM_DISPLAY_MODE 

Changes  the  PPM  display  modes. 

Calls  msg  ppm  display  mode:  sets  ppm_messagc_flag 
to  TRUE. 

MSG_PPM_DISPLAY_OFFSET 

Changes  the  PPM  display  offsets. 

Calls  msg_ppm_display_offset;  sets  ppm_message_flag 
to  TRUE. 

MSG_PPM_PIXEL_LOCATION 

Sets  a  new  PPM  pixel  location. 

Calls  msg_ppm  jjixelJocation;  sets  ppm_message_flag 
to  TRUE. 

MSG_PPM_PIXEL_STATE 

Turns  PPM  pixel  processing  on  or  off. 

Calls  msg_ppm_pixel_state;  sets  ppm_message_flag  to 
TRUE. 

MSG_SIO_CLOSE 

Closes  a  serial  HO  device. 

Calls  sio_close. 

MSG_SIO_INlT 

Opens  a  serial  HO  device. 

Calls  sio_init. 
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MSG_TF_INIT_HDR 

Controls  how  the  CIG  builds  terrain  feedback  messages. 
Calls  inx_push  to  push  MSG_BO_TF_INIT_HDR 
message  onto  Ballistics  message  queue;  if  "own" 
vehicle,  sets  flags,  vehicle  id,  counter,  and  frequency. 

MSG_TF_INrr_PT 

Speckles  point  for  which  terrain  feedback  is  desired. 

Calls  mx_push  to  push  MSG_BO_TF_INIT_PT 
message  onto  Ballistics  message  queue. 

MSG_TF_STATE 

Enables/disables  terrain  feedback  or  changes  frequency. 
Calls  mx_push  to  push  MSG_BO_TF_STATE  message 
onto  Ballistics  message  queue;  if  "own”  vehicle,  sets 
flags  or  changes  frequency  as  indicated. 

MSG_TRAJ_ENTRY 

Adds  an  entry  to  a  trajectory  table. 

Calls  mx_push  to  push  MSG_BO_TRAJ_ENTRY 
message  onto  Ballistics  message  queue. 

MSG_TRAJ_ENTRY_XFER 

Downloads  an  entry  to  a  Ballistics  trajectory  table. 
Verifies  table  has  room;  sets  trajectory  table  entry  data; 
calls  mx_push  to  push  MSG_BO_ADD_TRAJ_EbfrRY 
message  onto  Ballistics  message  queue. 

MSG_TRAJ_TABLE_XFER 

Sets  up  a  Ballistics  trajectory  table  to  be  downloaded. 
Verifies  no  other  table  is  in  load  process;  sets  data  for 
trajectory  table;  calls  mx_push  to  push 
MSG_BO_TRAJ_TABLE  message  onto  Ballistics 
message  queue. 

Called  By:  upstan 


Routines  Called:  ♦exchange_data 

cig_2d_setup 

cig_config 

cigsimio_msg_in 

cigsimio_msg_out 

config_color_table 

esifa_send_req 

fclose 

fopen 

get_3d_lut_name 

get_color_config_nanie 

get_data_2d_name 

get_database_name 

get_ded_name 

get_esifa_nanie 

get_final_lut_name 

GLOB 

init_subsys_parser 

load_dbase 

load_esifa 

mpvideo_derine_mode 

mpvideojoad 

msg_ppm_display_mode 

msg_ppm_display_offset 

msg_ppm_pixelJocation 
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msg_ppm_pixel_state 

mx_push 

open_dbase 

parse_subsys_file 

polLshutdown 

printf 

set_3d_lut_name 

set_color_config_name 

set_data_2d_name 

set_database_name 

set_ded_name 

set_esifa_niime 

set_final_lut_name 

set_token_file 

simulation 

sio_close 

sio_init 

start_watch 

strcmp 

strcpy 

strlen 

stmcmp 

SYSERR 


Parameters:  INT_2  state 


Returns:  none 


2.13.14  debug_initdr.c 

The  debug_initdr  function  calls  the  host_if_debug_tick  function  to  initiate  printing/display 
of  all  enabled  message  types  in  the  incoming  packet  buffer,  for  debugging  or  testing 
purposes. 

The  function  call  is  debug_initdr(). 

This  function  is  not  currently  used. 


Called  By: 
Routines  Called: 

Parameters: 

Returns: 


none 

host_if_debug_tick 

none 

none 
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2.13.15  ded_gin_pooI.c 

The  functions  in  the  ded.,gm_pool.c  CSU  are  used  to  create  and  manage  DED  memory 
ols.  The  standard  DED  pool,  pool  0,  is  used  for  3500-meter  databases.  In  7000-meter 
databases  with  large  DED  files,  a  second  pool  (pool  1)  can  be  allocated  and  used  also. 
Using  standard  load  module  AAM  to  store  extra  DED  models  is  called  DED  wrapping. 

The  functions  in  this  CSU  are: 

•  pooHnit 

•  pool_get_off_24 

•  addr_in_pool 

The  DED_POOL  structure,  used  to  manage  DED  memory,  specifies  the  pool's  start 
address,  next  and  last  available  bus  addresses,  DED  size,  total  byte  count,  and  the  offset  to 
add  to  model  addresses. 


2.13.15.1  pool_init 

The  pool_init  function  sets  up  DED  pool  0.  It  also  sets  up  pool  1  if  it  determines  that  the 
additional  memory  is  available  and  required. 

The  function  call  is  pooljnit  (pdbase,  avail_gm,  file_cut,  vme_offset),  where: 

pdbase  is  a  pointer  to  the  primary  database  control  block 

avail_gm  is  the  amount  of  hardware  memory  available  in  standard  generic  memory 

file  cut  is  the  size  of  pool  0  or  the  address  of  the  first  model  in  pool  1 

vme  offset  is  the  VME  address  offset  to  active  area  memory 

pooLinit  does  the  following: 

•  Set  up  DED  pool  O's  entries  using  the  passed  parameters. 

•  Initializes  DED  pool  I's  entries  to  0. 

•  Determines  whether  pool  0  is  large  enough  for  the  amount  of  generic  memory 
required. 

•  If  pool  0  is  not  large  enough: 

-  If  the  database  has  a  7(XX)-meter  viewing  range,  verifies  that  pool  1  is  large 
enough,  then  sets  up  pool  I's  entries. 

-  If  the  database  does  not  have  a  70(X)-meter  viewing  range,  outputs  an  error. 

The  function  returns  TRUE  if  it  successfully  initializes  pool  1  for  additional  generic 
memory.  It  returns  FALSE  if  pool  0  is  adequate,  or  if  additional  memory  is  required  but  in 
not  available. 


Called  By:  open_ded 


Routines  Called:  printf 
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Parameters: 

DB  INFO 

*pdbase 

INT  4 

avail_gm 

INT  4 

file_cut 

WORD 

vme_offs 

Returns: 

1  (TRUE) 

0  (FALSE) 

2.13.15.2  pooI_get_off_24 

The  pool_get_off_24  function  returns  the  appropriate  24-bit  offset  for  a  given  model 
address. 

The  function  call  is  pool_get_off_24(file_addr),  where /i/e  oddr  is  the  model  address. 

The  function  determines  which  pool  the  address  is  in  by  comparing  it  to  ihefile_cut  (the 
first  model  address  in  pool  1).  It  then  returns  the  offset  to  that  pool. 

Called  By  :  ded_model_trace 

Routines  Called:  none 


Parameters:  INT_4 


file_addr 


Returns:  '  pools[0].adr_offset  &  MASK_24 

pools[l].adr_offset  &  MASK_24 


2.13.15.3  addr_in_pool 

The  addr_in_pool  function  returns  TRUE  if  a  specified  address  is  valid  (i.e.,  is  within 
either  DED  pool). 

The  function  call  is  addr_in_pool(cmnd_addr,  msg),  where: 
cmnd  addr  is  the  command  address  to  be  checked 

msg  is  TRUE  if  an  error  message  is  to  be  output  if  the  address  is  valid,  or  FALSE  if 
no  output  message  is  desired 

If  the  cmnd  addr  is  in  either  DED  pool,  the  function  returns  TRUE. 

If  the  cmnd  addr  is  not  in  either  pool,  the  function  returns  FALSE.  If  msg  is  TRUE,  the 
function  also  outputs  an  error  message  showing  the  pool  boundaries. 


Called  By:  ded_model_trace 

open_ded 
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Routines  Called: 

printf 

Parameters: 

INT  4 

cmnd^addr 

BOOLEAN 

msg 

Returns: 

1  (TRUE) 

0  (FALSE) 

2.13.16  ded_modeI_trace.c 

The  ded_m<xiel_trace  function  traces  the  Data  Traversal  Processor  (DTP)  commands  for 
each  dynamic  model  and  special  effect,  and  adjusts  addresses  based  on  the  commands. 


The  function  call  is  ded_niodeI_trace(ded_size,  ded  start_adr, 
inodel_start_adr,  gm_end_adr,  shift_adr,  last_shlft_adr),  where: 

ded  size  is  the  amount  of  memory  available  for  all  dynamic  models  (in  both  DED 
pools,  if  both  are  allocated) 

ded  start  adr  is  the  starting  address  of  the  current  DED  pool 
model  start  adr  is  the  starting  address  of  the  model  to  be  traced 
gm  end  adr  is  the  highest  address  in  the  current  DED  pool 
shift jidr  is  the  address  to  shift  boundary  data  to 
last_shift_adr  is  the  last  possible  address  for  command  shifting 

ded_model_trace  does  the  following; 

•  Checks  the  model's  start  address  to  make  sure  it  is  in  one  of  the  DED  pools. 

•  Steps  through  each  DTP  command  for  each  model  and  each  special  effect. 

•  Resets  the  shift _adr. 

The  function  returns  the  final  value  of  shift _adr  if  it  is  successful.  It  returns  -1  if  the 
model's  address  is  not  in  either  DED  pool. 

The  macros  used  by  ded_model_trace  (DED_BOUNDARY,  PUSH_STACK,  and 
POP_STACK)  are  described  in  Appendix  B. 


Called  By:  open_ded 


Routines  Called:  addr_in_pool 

DED_BOUNDARY 

pool_get_off_24 

POP.STACK 

printf 

PUSH.STACK 


ded_size 

ded_start_adr 


Parameters:  INT_4 

INT_4 
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Returns: 


INT  4 

model_start_adr 

INT  4 

gm_end_adr 

INT  4 

shift_adr 

INT_4 

last_shift_adr 

shift  adr 

-1 

2.13.17  dl_inan.c  (dl_setup) 

The  dl_setup  function  initializes  various  active  area  memory  state  tables. 

The  function  call  is  dl_setup().  dl_setup  does  the  following: 

•  Initializes  tanks  and  other  vehicles  in  the  dynamic  state  table. 

•  Initializes  static  tanks  and  other  static  vehicles  in  the  static  state  table. 

•  Initializes  the  multiple-frame  effects  linked  list.  (This  structure  is  used  when 
showing  effects  over  multiple  frames.) 


Called  By: 
Routines  Called: 
Parameters: 

Returns: 


active_area_init 

INIT.MTX 

none 

none 


2.13.18  download_bvols.c 

The  download_bvols  function  downloads  model  directories,  model  entries,  and  bounding 
volumes  to  Ballistics. 

The  function  call  is  downIoad_bvoIs(header_P,  fd,  dev_P,  modeI_type),  where: 
header _P  is  a  pointer  to  the  database  header  data 

fd  is  an  identifier  for  the  file  containing  the  information  to  be  downloaded 
dev  P  is  a  pointer  to  the  Ballistics  message  queue 
model jype  is  BX_DED_MODEL_DIRECTORY 

download_bvols  does  the  following: 

♦  Allocates  memory  to  work  in. 

•  For  the  model  directory: 

-  Builds  a  structure  with  the  model  directory  data. 

Passes  the  data  to  Ballistics  by  calling  mx_push  to  push  a 
MSG_BO_MODEL_DIRECTORY  message  onto  the  Ballistics  message 
queue. 
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•  For  each  model  entry: 

-  Reads  the  entry  from  the  specified  file. 

-  Builds  a  structure  with  the  model's  data. 

-  Passes  the  data  to  Ballistics  by  calling  mx_push  to  push  a 
MSG_B0_MODEL_ENTRY  message  onto  the  Ballistics  message  queue. 

•  Frees  the  work  area  memory. 

•  Reads  and  validates  the  bounding  volume  count  from  the  database  header. 

•  Allocates  memory  to  work  in. 

•  For  each  bounding  volume  entry: 

-  Reads  the  entry  fitjm  the  specified  file. 

-  Converts  the  bounding  volume  from  fixed  point  to  floating  point. 

-  Builds  a  structure  wiA  the  bvol's  data. 

-  Passes  the  data  to  Ballistics  by  calling  mx_push  to  push  a 
MSG_BO_BVOL_ENTRY  message  onto  the  Ballistics  message  queue. 

•  Frees  the  work  area  memory. 

The  function  returns  0  if  successful.  It  returns  -1  if  the  number  of  bounding  volumes  is 
less  than  0. 


Called  By:  open_ded 


Routines  Called:  BCOPY 

fxbvtofl_020 

tnalloc 

mx_eiTor 

mx_push 

printf 

XLSEEK 

XREAD 


Parameters: 


DB_HDR_DBASE_DATA 

int 

MX_DEVICE 

BYTE 


*header_P 

fd 

*dev_P 

modeLtype 


Returns:  0 

-1 


2.13.19  effect_downcount.c 

The  effect_downcount  function  counts  down  the  frames  for  each  stamp  in  a  multiple-frame 
special  effect.  Once  the  complete  effect  has  been  displayed,  it  is  removed  from  the  active 
effects  table.  This  function  is  called  at  the  end  of  every  frame. 

The  function  call  is  effect_downcount(pdbase,  vme_offset),  where: 

pdbase  is  the  pointer  to  the  database  control  block 

vme  offset  is  the  VME  address  offset  to  active  area  memory 
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The  active  effects  table  is  maintained  in  the  first  backend's  active  area  memory  only. 


Called  By:  _downcount_effects 


Routines  Called:  none 


Parameters:  DB_INFO 

INT_4 


Returns:  none 


2.13.20  file_control.c 

The  file_control  function  processes  messages  from  the  Simulation  Host  to  handle  file 
transfers  to  and  firom  the  Simulation  Host,  delete  files,  and  produce  a  CIG  disk  directory 
list  for  the  Simulation  Host  file_control  is  called  whenever  the  state  requested  by  the 
Simulation  Host  is  C_FILE_XFER. 

The  function  call  is  file_control(state),  where  state  is  the  current  state  of  the  CIG 
system  (C_FILE_XFER). 

file_control  does  the  following: 

•  Calls  poll_shutdown  to  see  if  a  system  shutdown  has  been  requested. 

•  For  each  message  received  from  the  Simulation  Host: 

-  Verifies  that  the  packet  length  has  not  been  exceeded.  Calls  SYSERR  to 
generate  an  error  message  if  it  has. 

-  Calls  cigsitnio_msg_in  to  write  the  message  to  a  buffer  (if  message 
recording  or  debug  display  is  enabled). 

-  Processes  the  message  according  to  its  type  (see  table  below). 

The  following  table  surmnarizes  the  processing  performed  by  file_control  in  response  to 
each  valid  message  type  it  receives  from  the  Simulation  Host.  The  first  column  lists  the 
messages  in  alphabetical  order.  The  second  column  briefly  describes  the  purpose  of  the 
message  (in  it^cized  letters),  then  lists  the  major  steps  performed  by  file_control  to 
process  the  message. 


*pdbase 

vme_offset 
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Message  from  SIM  Host 

Processing  by  file_control 

MSG  CIG  CTL 

Causes  a  transition  to  another  performance  state. 

C  NULL 

No  action. 

C_STOP 

Returns  control  to  upstart. 

MSG.DRl  1_PKT_SIZE 

Specifies  exchange  packet  parameters. 

Sets  CIG  and  SIM  exchange  packet  sizes;  validates  local 
teirain  chunk  size  and  interv^,  and  sets  if  valid;  sets 

CIG  hardware  type. 

MSG_END 

Signals  end  of  packet  bi^er. 

Calls  cigsimio_msg_out  to  write  outgoing  message 
packet  to  buffo’  if  receding  is  enabled;  calls  ^propiate 
exchange.data  routine  (through  '*exchange_data)  to 
exchange  packets. 

MSG_FILE_DESCR 

Transfers  and  manages  files. 

DB_CIG2SIM 

Opens  and  reads  file  header,  genoates 
MSG_F1LE_STATUS  acknowledgement  message;  uses 
*exchange_data  to  exchange  packets;  transfers  and 
checksums  each  block;  generates  MSG_FILE_XFER 
acknowledgement  messages;  uses  *exchange_data  to 
exchange  packets;  closes  file. 

DB_SIM2CIG 

Calls  create_sz  to  create  file  with  specified  name  and 
size;  generates  MSG_FILE_STA’nJS  acknowledgement 
message. 

DB.DELETION 

Calls  system  to  delete  file  from  CIG  disk;  generates 
MSG_FILE_STATUS  acknowledgement  message. 

DB.DIRECTORY 

Passes  CIG  directory  contents  to  SIM  using 
MSG_FILE_DESCR  messages;  generates 
MSG_FILE_STATUS  acknowledgement  message. 

DB_REN_FROM 

Finds  file  with  specified  name;  generates 
MSG_FILE_STATUS  acknowledgement  message. 

DB_REN_TO 

Calls  system  to  rename  file  to  specified  name;  generates 
MSG_FILE_STATUS  acknowledgement  message. 

MSG_FILE_STATUS 

Provides  response  for  file  transfer. 

No  action  if  file  block  was  received;  resends  block  or 
aborts  if  SIM  reports  eirw. 

MSG_nLE_XFER 

Contains  the  data  to  upload  or  download. 

Reads  or  writes  data;  generates  MSG_FILE_STATUS 
return  message. 

Called  By;  upstart 


Routines  Called:  *exchange_data 

cigsimio_nisg_in 

cigsimio_msg_out 

close 

create_sz 

GLOB 

Iseek 

open 

polLshutdown 
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printf 

read 

rsec 

start_watch 

strcpy 

strlen 

SYSERR 

system 

write 


Parameters:  INT_2  state 

Returns:  none 


2.13.21  fxbvtofl.c 

The  functions  in  the  fxbvtofl.c  CSU  convert  fixed  point  bounding  volumes  to  floating 
point  These  functions  are: 

•  fxbvtofl_dart 

•  fxbvtofl 

•  fxbvtofl_020 


2.13.21.1  fxbvtofI_dart 

The  fxbvtofl_dart  function  converts  a  fixed  point  bounding  volume’s  vertex  list  to  floating 
point. 

The  function  call  is  fxbvtofl_dart(tobv,  frombv),  where: 

tobv  is  the  floating  point  bvol  entry 
frombv  is  the  fix^  point  bvol  entry 

This  function  is  not  currently  used. 


Called  By:  none 


Routines  Called:  FXT0881 

Parameters:  BVOL_ENTRY  ♦tobv 

FIX_BVOL_ENTRY  *frombv 

Returns:  none 
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2.13.21.2  fxbvtofl 

The  fxbvtofl  function  convcils  a  fixed  point  bounding  volume's  vertex  list  to  floating  point. 

The  function  call  is  fxbvtofl  (tobv,  frombv),  where: 

tobv  is  the  floating  point  bvol  entry 
frombv  is  the  fixed  point  bvol  entry 

This  function  is  not  currently  used. 

Called  By:  none 

Routines  Called:  FXTOfc’  8 1 

Parameters:  BVOL_ENTRY  *tobv 

FIX_BV0L_ENTRY  *frombv 


Returns:  none 


2.13.21.3  fxbvtofl_020 

The  fxbvtofl_020  function  converts  a  fixed  point  bounding  volume's  vertex  list  to  floating 
point. 

The  function  call  is  fxbvton_020(tobv,  frombv),  where: 

tobv  is  the  floating  point  bvol  entry 
frombv  is  the  fixed  point  bvol  entiy 


Called  By:  download_bvoIs 


Routines  Called:  FXT0881 

Parameters:  BVOL_ENTRY  *tobv 

FIX_BVOL_ENTRY  *frombv 


Returns: 


none 
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2.13.22  generic_lm.c 

The  functions  in  the  generic_lm.c  CSU  are  used  to  initialize  and  generate  a  generic  load 
module  containing  one  ocean  polygon.  This  allows  a  system  to  go  beyond  the  defined 
database  boundaries  while  still  retaining  some  orientation  reference. 

These  functions  are: 

•  init_generic_lm 

•  generic_lm 


2.13.22.1  init_generic_lm 

The  init_generic_lm  function  initializes  a  generic  load  module.  It  generates  the  load  module 
header,  the  required  DTP  commands,  and  the  grid  components. 

The  function  call  is  init_generic_lni(db_indcx,  view_range),  where: 

db  index  identifies  the  backend  (0  or  1) 

view  range  is  the  viewing  distance  in  meters  (3500  or  7(XX)). 

The  function  returns  FALSE  if  the  db_index  is  not  0  or  1. 


Called  By: 

load_modules 

Routines  Called: 

none 

Parameters: 

INT  4 

db_index 

INT_4 

view_range 

Returns: 

0  (FALSE) 

2.13.22.2  genericjm 

The  generic_lm  function  generates  the  generic  load  module.  It  copies  the  load  module  to 
memory,  then  updates  the  load  module  header,  DTP,  and  grid  components. 

The  function  call  is  generic_lni(db_index,  swx,  swy,  centoff,  memptr),  where; 

db  index  identifies  the  backend  (0  or  1) 
swx  is  the  x  coordinate  of  the  load  module's  southwest  comer 
is  the  y  coordinate  of  the  load  module’s  southwest  comer 
centoff  is  the  offset  to  the  center  of  the  load  module 
memptr  is  a  pointer  to  the  A  AM  location  for  the  new  load  module 
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Called  By: 

getside 

Routines  Called: 

none 

Parameters: 

INT  4 

db_index 

INT  4 

swx 

INT  4 

swy 

REAL  4 

centoff 

GENLM 

♦memptr 

Retfjms: 

none 

2.13.23  get_tx_lut_index.c 

The  get_tx_lut_index  function  returns  the  desired  final  output  color  table  index. 

The  function  call  is  get_tx_lut_index(pview_inode),  where  pview  mode  is  a  pointer 
to  the  system  view  mode.  The  function  does  the  following: 

•  Isolates  the  sky  color  (sky). 

•  Isolates  the  time  of  day  (^y). 

•  Isolates  the  thermal  flag  (thm). 

•  If  thm  is  1  and  the  therm^_mode_wanted  variable  is  TRUE,  returns  10  (the  default 
thermal).  If  not,  returns  (sky  *  3  +  day). 

This  function  is  not  currently  used. 


Called  By: 

none 

Routines  Called: 

GLOB 

Parameters: 

INT_4 

*pview_mode 

Returns: 

sky  *  3  +  day 

10 

2.13.24  globaMnit.c 

The  global_initc  CSU  contains  functions  that  initialize  various  global  variables.  These 
functions  are: 

•  host_if_buffer_init 

•  host_init_packet_sizes 
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2.13.24.1  host_if_buffer_init 

The  host_if_buffer_init  function  initializes  the  output  buffer  header  (packet  version  number 
and  level)  and,  optionally,  the  input  and  output  message  buffers  (IhreUF  and  OUTBUF). 

The  function  call  is  host_if_buffer  init  (init_INBUF_and_OUTBUF),  where 
init  INBUF  and  OUTBUF  is  TRUElf  the  message  buffers  are  to  be  initialize. 


Called  By: 


init_mpv_interface 

initialie 


Routines  Called: 

Parameters: 

Returns: 


none 

BOOLEAN 


none 


init_INBUF_and_OUTBUF 


2.13.24.2  host_init_packet_sizes 

The  host_init_packet_sizes  function  initializes  the  following  global  variables  to  their  default 
values,  if  they  have  not  yet  been  set: 

•  DRl  1  incoming  and  outgoing  exchange  packet  sizes. 

•  SCSI  incoming  and  outgoing  exchange  packet  sizes. 

•  Local  terrain  chunk  size. 

•  Interval  between  local  terrain  messages. 

The  function  call  is  host_init_packet_sizes(). 


Called  By: 

initialize 

Routines  Called: 

none 

Parameters: 

none 

Returns: 

none 

2.13.25  gun_overIays.c 

The  functions  in  the  gun_overlays.c  CSU  are  used  to  build  Ml  and  M2  overlays.  These 
overlays  are  hard-coded  displays  of  three-dimensional  polygons  that  are  displayed  on  the 
viewport,  over  the  terrain  display.  The  overlay  shows  objects  that  would  normally  obscure 
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the  view  of  the  terrain,  to  better  emulate  the  real-world  view  out  the  vehicle's  window. 
These  overlays  are  vehicle-specific. 

gun_ovprlays.c  contains  the  following  functions: 


•  ml_gun_overlay 

•  m2_gun_overlay 

•  make_ml_overlays 

•  make_m2_overlays 


These  functions  apply  to  T  backends  only.  Overlays  for  TX  backends  are  generated  by  the 
2-D  Overlay  Compiler  CSC  using  Simulation  Host  messages. 


2.13.25.1  inl_gun_overlay 

The  ml_gun_overlay  function  creates  gun  and  gunner  overlays  for  Ml  vehicles.  This 
function  is  called  when  the  message  from  the  Simulation  Host  is  MSG_GUN_OVERLA Y 
and  the  message  type  is  Ml_OVERLAYS. 

Gun  overlays  show  the  components  of  the  gun  (on  the  simulation  vehicle)  that  would  be 
visible  when  looking  out  from  the  vehicle's  window.  Gunner  overlays  show  cross-hairs 
and  digits.  The  MSG_GUN_OVERLAY  message  specifies  the  digits  to  be  displayed. 

The  function  call  is  nil_gun_overlay(pmsg,  db),  where: 

pmsg  is  a  pointer  to  the  MSG_GUN_OVERLAY  message 
db  is  the  double-buffer  memory  current  base  pointer 

ml _gun_overlay  does  the  following: 

•  Checks  to  see  if  an  overlay  has  been  defined. 

•  Updates  the  gun  barrel  viewport-to-turret  transformation  matrix. 

•  Updates  the  gunners  overlay  polygons. 


Called  By:  process_a_msg 


Routines  Called:  syserr 


Parameters:  MSG_GUN_OVERLAY  *pmsg 

INT_4  db 


Returns:  none 


2.13.25.2  m2_gun_overIay 

The  m2_gun_overlay  function  creates  gun  overlays  for  M2  vehicles.  This  function  is 
called  when  the  message  from  the  Simulation  Host  is  MSG_GUN_OVERLAY  and  the 
message  type  is  M2_OVERLAYS. 
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Gun  overlays  show  the  components  of  the  gun  (on  the  simulation  vehicle)  that  would  be 
visible  when  looking  out  from  the  vehicle’s  window.  Gunner  overlays  siiow  cross-hairs 
and  digits.  The  MSG_GUN_OVERLAY  message  specifies  the  digits  to  be  displayed. 

The  function  call  is  m2_gun_overlay(pinsg,  db),  where; 

pmsg  is  a  pointer  to  the  MSG_GUN_OVERLAY  message 
db  is  the  double-buffer  memory  current  base  pointer 

nt2_gun_overlay  does  the  following: 

•  Checks  to  see  if  an  overlay  has  been  defined. 

•  Updates  the  gun  barrel  viewport-to-tuiret  transformation  matrix. 

•  Updates  the  gunners  overlay  polygons. 


Called  By: 
Routines  Called; 

Parameters: 


process_a_msg 


syserr 

MSG_GUN_OVERLAY 

INT_4 


Returns:  none 


*pmsg 

db 


2.13.25.3  make_ml_overlays 

The  make_ml_overlays  function  sets  up  Ml  overlay  data  at  viewport  configuration  time. 

This  function  is  called  if  the  Simulation  Host  sends  a  MSG_OVERLAY_SETUP  message 

with  the  type  set  to  1  (Ml_OVERLAYS). 

Note:  The  MSG  JDVERLAY _SETUP  message  can  specify 

gunners  viewport  (the  viewport  that  is  to  have  the  gunner’s  overlay) 
and  barrel  viewports  (the  viewports  the  gun  barrel  is  to  be  viewable 
in).  These  values  are  not  currently  used.  The  gunner’s  overlay  is 
placed  on  any  viewport  belonging  to  a  configuration  node  that  has 
bit  0  of  its  branch  mask  set.  The  gun  barrel  overlay  is  placed  on  any 
viewport  belonging  to  a  configuration  node  that  has  bit  1  of  its 
branch  mask  set. 

The  function  call  is  make_ml_overlays(po,  ppg),  where: 

po  is  a  pointer  to  the  overlay  parameters 

ppg  is  a  pointer  to  the  Ml_GUN_OVERLAY  message 

make.,ml. .overlays  does  the  following: 

•  Allocates  memory  for  the  overlay. 

•  Outputs  the  matrix,  vertex  list,  digits,  ASCII  data,  etc. 
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•  Lx>ads  the  overlay  digit  vertices. 

•  Sets  up  the  gun  tube  overlay. 

•  Sets  up  the  matrix  command. 

•  Generates  the  gun  barrel  polygon  component. 

•  Sets  the  overlay_defmed  flag  to  TRUE. 


Called  By: 
Routines  Called: 


overlay_setup 


aam.  .malloc 
id_^x3mtx 
make_p_nt 
swap_a.xis 


Parameters:  OVERLAY_PARAMS 

Ml_GUN_OVERLAY 


*po 

**ppg 


Returns:  none 


2.13.25.4  make_m2_overlays 

The  make_m2_overlays  routine  sets  up  M2  overlay  data  at  viewport  configuration  time. 

This  function  is  called  if  the  Simulation  Host  sends  a  MSG_OVERLAY_SETUP  message 

with  the  message  type  set  to  2  (M2_OVERLAYS). 

Note:  The  MSG  OVERLAY  SETUP  message  can  specify 

gunners _viewport  (the  viewport  that  is  to  have  the  gunner's  overlay) 
and  barrel _yiewports  (the  viewports  the  gun  barrel  is  to  be  viewable 
in).  These  values  are  not  currently  used.  The  gunner's  overlay  is 
placed  on  any  viewport  belonging  to  a  configuration  node  that  has 
bit  0  of  its  branch  mask  set.  The  gun  barrel  overlay  is  placed  on  any 
viewport  belonging  to  a  corfiguration  node  that  has  bit  1  of  its 
branch  mask  set. 

The  function  call  is  make_m2_overlays(po,  ppg),  where: 

po  is  a  pointer  to  the  overlay  parameters 

ppg  is  a  pointer  to  the  M2_GUN_OVERLAY  message 

make_m2_overlays  does  the  following: 

•  Allocates  memory  for  the  overlay. 

•  Builds  the  gunner  display  buffer. 

•  Loads  the  matrix. 

•  Outputs  the  gunner  polygons. 

•  Loads  the  overlay  digit  vertices. 

•  Sets  up  the  gun  tube  overlay. 

•  Sets  up  the  matrix  command. 

•  Generates  the  gun  barrel's  top,  right,  and  left  polygon  components. 

•  Sets  the  overlay _defined  flag  to  TRUE. 
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Called  By;  overlay_setup 


Routines  Called:  aam_malloc 

id_4x3mtx 

makej)_nt 

swap_axis 


Parameters:  OVERLAY_PARAMS  *po 

M2_GUN_0VERLAY  **ppg 


Returns:  none 


2.13.26  hw_test.c 

The  hw_test  function  processes  messages  from  the  Simulation  Host  to  perform  hardware 
tests.  hw_test  is  called  whenever  the  state  requested  by  the  Simulation  Host  is 
C_TEST_MODE. 

Note:  Hardware  tests  are  not  currently  implemented. 

The  function  call  is  hw_test(state),  where  state  is  the  current  state  of  the  CIG  system 
(C_TEST_MODE). 

hw_test  does  the  following: 

•  Calls  polLshutdown  to  see  if  a  system  shutdown  has  been  requested. 

•  For  each  valid  message  type  it  receives: 

-  Verifies  that  Ae  packet  length  has  not  been  exceeded;  calls  SYSERR  to 
generate  an  error  message  if  it  has. 

-  Calls  cigsimio_msg_in  to  write  the  message  to  a  buffer  (if  message 
recording  or  debug  display  is  enabled). 

-  Processes  the  message  according  to  its  type  (see  table  below). 

The  following  table  summarizes  the  processing  p>erformed  by  hw_test  in  response  to  each 
valid  message  type  it  receives  from  the  Simulation  Host.  The  first  column  lists  the 
messages  in  alphabetical  order.  The  second  column  briefly  describes  the  purpose  of  the 
message  (in  it^ics),  then  lists  the  major  steps  performed  by  hw_test  to  process  the 
message. 
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Message  from  SIM  Host 

Processing  by  hw_test 

MSG  QG  CTL 

C  NULL 

C_STOP 

Causes  a  transition  to  another  performance  state. 

No  action. 

Returns  to  upstart. 

MSG_DR1 1_PKT_SIZE 

Specifies  exchange  packet  parameters. 

Sets  CIG  and  SIM  exchange  packet  sizes;  validates  local 
terrain  chunk  size  and  message  intoval,  and  sets  if  valid; 
sets  CIG  hardware  type. 

MSG_END 

Signals  end  of  packet  biffer. 

Calls  cigsimio_msg_out  to  write  outgoing  message 
packet  to  buffer  if  recording  is  enabled;  calls 
start_watch;  calls  an>iDpriate  cxchange_data  routine 
(through  *exchange_data)  to  exchange  packets. 

MSG  TEST  NAME 

ECHO.PKT 

Specifies  test  to  be  run. 

No  action;  test  is  not  yet  implemented. 

Called  By:  upstart 


Routines  Called: 


*exchange_data 

cigsiimo_msg_in 

cigsimio_msg_out 

GLOB 


polLshutdown 

start_watch 

SYSERR 


Parameters:  INT_2  state 

Returns:  none 


2.13.27  init_siin.c  (init_simulation) 

The  init_simulation  function  initializes  a  new  simulation.  This  function  is  called  whenever 
the  Simulation  Host  sends  a  CIG  Control  message  with  the  new  CIG  state  set  to 
C_SIMULATION  or  C_MCC_SIMUL. 

The  function  call  is  init_simulation  (state,  curr_sim_buf,  sim  pdbase,  pdynl, 
ptanks,  pmodels,  peffects),  where: 

state  is  the  state  the  CIG  is  to  be  set  up  in  (C_DB_SETUP  or  C_MCC_SETUP) 

curr_sim_birf  is  the  double  buffer  currently  being  loaded  by  the  simulation 

sim  jjdbase  is  a  pointer  to  the  primary  database  control  block 

pdynl  is  a  pointer  to  the  structure  containing  the  current  state  of  all  dynamic  models 

ptanks  is  a  pointer  to  the  tank  table 

pmodels  is  a  pointer  to  the  model  table 

peffects  is  a  pointer  to  the  dynamic  effects  table 
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init_simulation  does  the  following: 

•  If  AGPT  mode  is  enabled,  calls  sim_gmbox.  AGPT  mode  is  a  non-standard 
version  of  the  GTIOO  system. 

•  Initializes  various  variables. 

•  Creates  a  dummy  system  view  flags  message  to  initialize  the  array. 

•  Calls  backend_sim_init  to  prepare  the  backend  to  run  a  simulation. 

•  Calls  sim_bal_init  to  initiahze  variables  used  in  Ballistics  messages. 

•  Calls  sim_bal_start  to  put  Ballistics  into  the  run  state  and  tell  it  where  active  area 
memory  is. 

•  Initializes  the  simulated  vehicle's  AGL  (altitude  above  ground  level). 

•  Zeroes  the  system  frame  counter. 

•  Initializes  the  static  tank  and  model  pointers. 

•  Initializes  the  multiple  and  long  effects  pointers. 

•  If  a  second  AAM  is  present,  initializes  its  static  tank  and  model  pointers,  and 
multiple  and  long  effects  pointers. 

•  Initializes  the  static  vehicle  pointers  to  multiple-frame  effects. 

•  Initializes  the  multiple-frame  effects  pointers  to  subroutine  calls. 

•  Turns  off  the  system  view  flags. 

•  If  a  second  AAM  is  present,  updates  it  also. 

•  Clears  any  stray  messages  ft^om  the  SIMULATION_MB  mailbox. 

•  Posts  a  message  and  waits  for  the  rowcol_rd  task(s)  to  perform  database 
management  (unless  database  updates  were  disabled  on  the  startup  command  line). 

•  Posts  a  message  and  waits  for  local_terrain  to  perform  database  feedback;  sets  the 
local  terrain  count  to  0. 

•  Calls  sysrup_on  to  enable  system  interrupts. 

•  Calls  sim_bal_frame_rate  to  tell  Ballistics  the  current  CIG  frame  rate. 

•  Calls  get_dtp_bank  to  determine  which  double  buffer  to  use. 

•  Sets  pointers  to  the  dynamic  model  state  table  and  the  tank,  model,  and  effects 
tables. 

•  If  a  second  AAM  is  present,  sets  pointers  to  its  tank,  model,  and  effects  tables. 

•  Calls  _pend_on_frame_interrupt  to  wait  for  the  next  frame  interrupt. 


Called  By;  simulation 


Routines  Called:  _pend_on_frame_interrupt 

AAM2_ADDR 

backend_sim_init 

blcopy 

exit 

get_dtp_bank 

perror  (in  AGPT  mode  only) 

printf 

sc_accept 

sc_pend 

sc_post 

sim_bal_frame_rate 

sim_bal_init 

sim_bal_start 

sim_gmbox  (in  AGPT  mode  only) 

sysrup_on 
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Parameters: 

INT  2 

state 

INT  2 

*curr_sim_buf 

DB  INFO 

**sim_pdbase 

INT  4 

**pdynl 

TANK 

♦♦ptanks 

INT  4 

♦♦pmodels 

INT_4 

♦*peffects 

Returns: 

none 

2.13.28  load_dbase.c 

The  load_dbase  function  loads  the  terrain  database  into  active  area  memory,  and  sets  up 
various  tables  with  the  necessary  data  from  the  database.  It  also  calls  open_ded  to  load  the 
contents  of  the  dynamic  elements  database  (DED).  load_dbase  is  called  after  the  viewport 
configuration  tree  has  been  created. 

The  function  call  is  load_dbase(pdbase),  where  pdbase  is  a  pointer  to  the  primary 
database  control  block.  ” 

load_dbase  does  the  following: 

•  Determines  how  much  generic  memory  is  available.  (This  controls  how  many 
models  can  be  read  in.) 

•  If  not  enough  memory  is  available,  truncates  the  number  of  bytes  to  what  is 
available. 

•  Reads  in  the  data  from  the  specified  database. 

•  Reads  in  the  overflow  terrain  data,  if  there  is  sufficient  room. 

•  Calls  open_ded  to  open  the  dynamic  elements  database,  read  the  models  in,  and 
process  them. 

•  Calls  load_modules  to  load  the  initial  load  modules. 

•  Initializes  the  Load  Module  Branch  Table,  subroutine  call  table,  and  field-of-view 
test  table  for  a  3500-meter  or  7000-meter  viewing  range. 


Called  By:  db_mcc_setup 


Routines  Called:  bus_error 

load_modules 

open_ded 

printf 

XLSEEK 

XREAD 


Parameters:  DB_INFO  *pdbase 

Returns:  none 


497 


BBN  Systems  and  Technologies 


GTIOO  RTSW  CSCI 


2.13.29  load  esifa.c 


The  load_esifa  function  downloads  textures  data  to  the  ESIFA,  for  later  download  to  the 
Pixel  Processor  Tilers  (PPTs).  This  function  is  called  when  the  backend  is  set  up  at  system 
initialization  time. 


The  function  call  is  load_esifa(pniename,  id),  where: 

Pfftlename  is  the  name  of  the  ESIFA  textures  file 
id  is  the  backend  id 


load_esifa  does  the  following: 

•  Makes  sure  the  esifa_load_wanted  variable  is  TRUE. 

•  Opens  the  specified  file. 

•  Reads  the  first  line  of  the  file  to  get  the  masks  and  file  name  need  by  esifa_load. 

•  Calls  esifajoad  to  load  the  data  into  the  subsystem  boards. 

•  Closes  the  file. 


Called  By: 

backend_setup 

Routines  Called: 

esifajoad 

fclose 

fgets 

fopen 

printf 

sscanf 

Parameters: 

UNS  1 

INT_4 

Returns: 

none 

*pfilenameD 

id 


2.13.30  load  modules.c 


The  functions  in  the  load_modules.c  CSU  are  used  to  load  new  active  area  rows  and 
columns  from  the  terrain  database  when  required.  These  functions  are: 


load_modules 

getlmdp 

getside 

whatdirptr 
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2.13.30.1  loa(l_inodules 

The  load_modules  function  loads  a  portion  of  the  terrain  database  into  AAM,  when  AAM 
needs  to  be  completed  loaded  or  reloaded.  This  function  is  called  to  read  the  initial  load 
iiKxlules  into  AAM,  and  is  called  during  a  simulation  if  the  simulated  vehicle  is  detected  to 
be  out  of  viewing  range  of  active  area  memory.  (Specifically,  the  vehicle  must  be  more 
than  one-half  the  width  of  AAM  outside  its  boundaries.  In  Ais  instance,  none  of  the  terrain 
that  is  currently  visible  to  the  vehicle  is  in  AAM  —  usually,  this  is  due  to  "warping"  across 
the  terrain.  The  _rowcol_rd  function  then  calls  load_modules  to  rebuild  all  of  AAM  based 
on  the  vehicle's  current  location.) 

The  function  call  is  load_modules(pdbase),  where  pdbase  is  a  pointer  to  the  primary 
database  control  block.  ~ 

load_modules  does  the  following: 

•  Determines  the  viewing  range. 

•  Calls  init_generic_lm  to  initialize  a  generic  load  module  for  the  applicable  viewing 
range. 

•  Initializes  the  direction  offsets. 

•  Calculates  the  southwest  comer  of  AAM  based  on  the  current  coordinates  of  the 
simulated  vehicle. 

•  Calculates  the  four  borders  of  AAM. 

•  Starting  at  the  southernmost  row  and  working  up,  reads  each  AAM  row  from  west 
to  east,  calling  getside  to  load  the  appropriate  load  modules  from  the  database. 

•  Calls  whatdirptr  to  find  the  direction  pointer  after  the  first  row  of  load  modules  is 
loaded. 

•  After  reaching  the  northernmost  row,  resets  the  address  of  the  south  border. 


CaUed  By: 


_rowcol_rd 

load_dbase 


Routines  Called:  getside 

GLOB 

init_generic_lm 

printf 

whatdirptr 


Parameters:  DB_INFO  *pdbase 


Returns:  none 


2.13.30.2  getlmdp 

The  getlmdp  function  gets  a  load  module's  disk  pointer  from  the  database. 
The  function  call  is  getlmdp(xmod,  ymod,  pdbase),  where: 
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xmod  is  the  load  module  array  number  x 
ymod  is  the  load  module  array  number  y 
pdbase  is  a  pointer  to  the  primary  database  control  block 

The  function  returns  0  if  the  load  module  is  not  in  the  database.  If  0  is  returned,  getside 
(the  calling  function)  calls  genericjm  to  get  a  generic  load  module. 


Called  By: 

getside 

Routines  Called: 

XLSEEK 

XREAD 

Parameters: 

INT  4 

xmod 

INT  4 

ymod 

DB_INFO 

*pdbase 

Returns: 

dbde.lm  loc 

0 

2.13.30.3  getside 

The  getside  function  loads  part  of  a  row  or  column  from  the  terrain  database  into  active  area 
memory.  The  number  of  load  modules  in  the  row  or  column  actually  loaded  into  AAM  is 
16  (the  normal  height/width  of  AAM)  or  32  (the  height/width  of  AAM  if  load  module 
blocking  is  enabled). 

The  function  call  is  getside(lmdloc,  xmod,  ymod,  xinc,  yinc,  diroff,  pdbase, 
zeroit),  where: 

Imdloc  is  a  pointer  to  the  first  load  module  on  disk 

xmod  is  the  first  load  module's  array  number  x  (west  column) 

ymod  is  the  first  load  module's  array  number  y  (south  row) 

xinc  is  the  load  module's  array  number  increment  x 

yinc  is  the  load  module's  array  number  increment  y 

diroff  is  a  byte  offset  to  the  directory  pointer  in  the  load  module  header 

pdbase  is  a  pointer  to  the  primary  database  control  block 

zeroit  is  a  flag  used  to  determine  when  the  running  average  load  module  centroid  should 
be  zeroed 

getside  does  the  following  for  each  new  load  module  it  loads  into  AAM: 

•  Sets  the  load  module  number  and  gets  its  AAM  address. 

•  Calls  getimdp  to  get  the  load  module's  disk  pointer  from  the  database. 

•  If  the  load  module  is  not  in  the  database,  calls  generic_lm  to  get  a  generic  load 
module. 

•  Reads  in  the  load  module. 

•  If  working  in  subsystem  0,  informs  Ballistics  of  the  new  load  module  by  pushing  a 
MSG_B0_LM_READ  message  onto  the  Ballistics  message  queue. 
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*  Updates  the  field-of-view  tables  for  the  new  load  module. 


CaUedBy: 

_rowcol_rd 

load_modules 

Routines  Called: 

getlmdp 
generic  hn 
GLOB 

mx  push 
XLSEEK 

XREAD 

Parameters: 

WORD 

Imdloc 

INT  4 

xmod 

INT  4 

ymod 

INT  4 

xinc 

INT  4 

yinc 

WORD 

diroff 

DB  INFO 

♦pdbase 

WORD 

zeroit 

Returns: 

none 

2.13.30.4  whatdirptr 

The  whatdirptr  function  finds  the  direction  pointer  for  the  load  module  at  a  specified 
location  in  a  specified  direction. 

The  function  call  is  whatdirptr(xmod,  ymod,  diroff,  pdbase),  where: 

xmod  is  the  load  module's  array  number  x  (west  column) 

ymod  is  the  load  module's  array  number  y  (south  row) 

diroff  is  the  byte  offset  to  the  dkection  pointer  in  the  load  module  header 

pdbase  is  a  pointer  to  the  primary  database  control  block 


Called  By:  _rowcol_rd 

load_modules 


Routines  Called:  none 


Parameters:  INT_4  xmod 

INT_4  ymod 

WORD  diroff 

DB_INFO  *pdbase 
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Returns:  cdirection  pointer^ 


2.13.31  loc_ter.c 

The  loc_ter.c  CSU  contains  functions  used  to  build  local  terrain  messages  for  return  to  the 
Simulation  Host.  This  feature  is  called  "database  feedback."  These  functions  are: 

•  local_terrain 

•  local_teiTain_cleanup 

A  local  terrain  message  describes  the  terrain,  roads,  rivers,  and  buildings  that  lie  within  the 
four  grids  surrounding  the  simulated  vehicle.  (One  grid  is  usually  125  meters  per  side. 
One  load  module  is  defined  as  four  grids;  two  rows  by  two  columns.) 

The  first  frame  at  which  a  local  terrain  message  is  created,  and  the  frame  interval  at  which 
new  messages  are  generated,  are  defined  in  the  memory_map_defines.h  file.  Currently, 
the  first  frame  is  set  to  16  and  the  default  interval  is  set  to  32.  The  interval  can  be  changed 
using  the  MSG_DR1 1_PKT_SIZE  or  MSG_LT_STATE  message. 

Local  terrain  messages  can  also  be  sent  on  demand  in  response  to  a  MSG_RTN_LT  (return 
local  terrain)  message.  This  message  is  to  be  used  by  the  MCC  station  only. 

Each  local  terrain  message  contains  the  following: 

•  A  header  that  specifies  the  number  of  polygon  definitions  and  the  number  of 
bounding  volumes  (bvols)  contained  in  the  message. 

•  Polygons  that  describe  the  local  terrain  and  the  objects  in  it.  These  polygons  are 
planar,  convex,  and  three-  or  four-sided.  Each  polygon  entry  in  the  message 
specifies  the  soil  type,  priority  code,  minimum  and  maximum  coordinates,  and  all 
polygon  vertices  in  counter-clockwise  order. 

•  Bounding  volumes.  A  bvol  definition  contains  one  or  more  four-sided  bounding 
boxes  each  of  which  has  a  planar,  convex,  polygonal  base  and  a  height  (expressed 
in  units  on  the  z  axis)  for  the  volume  given.  Each  bvol  entry  in  the  message 
specifies  the  bvol's  height  above  the  polygonal  base,  the  bvol  type  identifier,  the 
minimum  and  maximum  coordinates,  and  the  vertex  list. 


2.13.31.1  local_terrain 

The  local_terrain  function  builds  local  terrain  messages  based  on  the  simulated  vehicle's 
current  position.  These  messages  are  used  by  the  Simulation  Host  to  provide  collision 
detection  with  objects  in  the  simulated  environment,  and  to  calculate  the  dynamics  of  the 
vehicle  in  operation. 

The  local_terrain  task  is  loaded  during  the  task  initialization  state.  It  is  then  suspended  until 
a  message  is  posted  to  its  mailbox  (LOCAL_TERRAIN_MB).  local_tetrain  assumes  that 
the  simulation  vehicle's  current  position  (stored  in  the  viewport  positions  array)  has  just 
been  updated. 

local_terrain  does  the  following: 
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•  Initializes  the  local  terrain  output  buffer  header  (version  and  level). 

•  Calls  polLshutdown  to  see  if  a  system  shutdown  has  been  requested. 

•  Waits  for  a  message  to  be  posted  to  the  LOCAL_TERRAIN_MB  mailbox. 

•  Calls  bal_get_db_pos  to  find  the  simulated  vehicle's  current  load  module  number 
and  grid  number. 

•  Calls  bal_get_lm_grid  to  find  the  four  grids  that  surround  the  simulated  vehicle. 

•  Determines  whether  a  new  local  terrain  message  needs  to  be  built  (i.e.,  if  the 
simulated  vehicle's  position  has  changed  since  the  last  local  terrain  message). 

•  If  the  vehicle  has  moved,  reinitializes  the  local  terrain  output  buffer. 

•  Searches  the  four  grids  that  lie  around  the  simulated  vehicle  for  polygons,  and 
builds  the  polygon  portion  of  the  message. 

•  Searches  the  four  grids  that  lie  around  the  simulated  vehicle  for  polygon 
components,  and  builds  the  polygon  ccmiponent  portion  of  the  message. 

•  Searches  the  four  grids  that  he  around  the  simulated  vehicle  for  bounding  volumes, 
and  builds  the  bvol  portion  of  the  message. 

•  Sets  a  pointer  to  the  new  local  terrain  message  data. 

•  C^reates  the  message  header:  message  size,  message  type 
(MSG_LOCAL_TCRRAIN),  and  the  total  number  of  polygons  and  bvols  in  the 
message.  (The  full  message  is  divided  into  a  series  of  smaller  MSG_LT_PIECE 
messages  by  loc_ter_msg  in  the  Message  Processing  CSC.) 

•  Posts  a  message  to  the  RTN_TERRAIN_MB  mailbox. 


Called  By.  none  (task  created  and  started  at  initialization) 


Routines  Called:  bal_get_db_pos 

bal_get_lm_grid 

FXT0881 

GLOB 

polLshutdown 

printf  (in  debug  mode  only) 

read_watch 

rt_pend 

rt_post 


Parameters:  none 

Returns:  none 


2.13.31.2  locaI_terrain_cleanup 

The  local_terrain_cleanup  function  deallocates  the  resources  owned  by  the  local_terrain 
task.  This  function  is  called  if  a  system  shutdown  is  requested  by  the  Gossip  user.  The 
function  is  called  via  the  *task_cleanup  function  pointer,  which  points  to  the  cleanup 
routine's  name  in  the  task  table. 

The  function  call  is  locaLterrain_cleanup(). 

The  function  returns  1  if  successful,  or  0  if  an  error  occurred. 
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Note:  This  function  is  not  yet  inyjlemented.  At  the  current  time,  it  simply 
returns  a  1  if  called. 


Called  By: 


polLshutdown  (through  *task_cleanup) 


Routines  Called:  none 


Parameters: 


none 


Returns: 


0 

1 


2.13.32  make_bbn.c 

The  functions  in  the  make_bbn.c  CSU  can  be  used  to  make  and  modify  hull-to-world 
matrices.  These  functions  are: 

•  prt_mtx 

•  rotate_x 

•  rotate_y 

•  rotate_z 

•  multmatrix 

•  id_matrix 

Note:  These  routines  are  called  only  by  model jntx,  which  is  not  currently 
called  by  any  other  function.  Therefore,  these  functions  are  not 
currently  used. 


2.13.32.1  prt_mtx 

The  prt_mtx  function  copies  a  matrix  in  memory. 

The  function  call  is  prt_mtx(matrix,  pntr),  where: 
matrix  is  the  matrix 

pntr  is  a  pointer  to  the  destination  memory  location 


Called  By: 

model_mtx 

Routines  Called: 

none 

Parameters: 

REAL  4 

matrix[4][3] 

REAL_4 

*pntr 
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Returns:  none 


2.13.32.2  rotate_x 

The  rotate_x  function  rotates  a  matrix  about  the  X  axis.  It  creates  an  identity  matrix,  rotates 
it  appropriately,  then  multiplies  it  by  the  original  matrix. 

The  function  call  is  rotate_x(theta,  matrix),  where: 

theta  is  the  angle  of  rotation 
matrix  is  the  matrix  to  be  rotated 


Called  By: 

model_mtx 

Routines  Called: 

cos 

id_matrix 

multmatrix 

sin 

toradians 

Parameters: 

REAL  4 

theta 

REAL_4 

matrix[4][3] 

Returns: 

none 

2.13.32.3  rotate_y 

Tlie  rotate_y  function  rotates  a  matrix  about  the  Y  axis.  It  creates  an  identity  matrix,  rotates 
it  appropriately,  then  multiplies  it  by  the  original  matrix. 

The  function  call  is  rotate_y(theta,  matrix),  where: 

theta  is  the  angle  of  rotation 
matrix  is  the  matrix  to  be  rotated 


Called  By:  model_mtx 


Routines  Called:  cos 

id_matrix 

multmatrix 

sin 

toradians 


Parameters:  REAL_4 

REAL_4 


theta 

matrix  [4]  [3] 
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Returns:  none 


2.13.32.4  rotate_z 

The  rotate_z  function  rotates  a  matrix  about  the  Z  axis.  It  creates  an  identity  matrix,  rotates 
it  appropriately,  then  multiplies  it  by  the  original  matrix. 

The  function  call  is  rotate_z(theta,  matrix),  where: 

theta  is  the  angle  of  rotation 
matrix  is  the  matrix  to  be  rotated 


Called  By:  model_mtx 


Routines  Called:  cos 

id_matrix 

multmatrix 

sin 

toradians 


theta 

matrix  [4]  [3] 


Returns:  none 


Parameters:  REAL_4 

REAL_4 


2.13.32.5  multmatrix 

The  multmatrix  function  multiplies  (concatenates)  two  matrices  together.  This  function  is 
used  to  multiply  a  matrix  by  a  rotation  matrix. 

The  function  call  is  multmatrix(matrix,  matrix_tmp),  where: 

matrix  is  the  rotation  matrix 
matrix  tmp  is  the  matrix  to  be  rotated 


Called  By:  rotate_x 

rotate_y 

rotate_z 


Routines  Called:  none 


Parameters:  REAL_4 

REAL_4 


matrix[4][3] 

matrix_tmp[4][3] 
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Returns:  none 


2.13.32.6  id_inatrix 

The  id_matrix  function  creates  an  identity  matrix  (positioned  at  the  origin)  for  use  in 
rotating  matrices. 

The  function  call  is  id_matrix(matrix),  where  matrix  is  the  identity  matrix  to  be  created. 


Called  By: 

model_mtx 

iotate_x 

rotate_y 

rotate_z 

Routines  Called: 

none 

Parameters: 

REAL_4 

matrix  [4]  [3] 

Returns: 

none 

2.13.33  inkmtx_nt.c 

The  functions  in  the  mkmtx_nt.c  CSU  are  used  to  perform  computations  on  matrices. 
These  functions  are: 

•  make_p_nt 

•  rotate_x_nt 

•  rotate_y_nt 

•  rotate_z_nt 

•  swap_axis 

•  id_4x3mtx 

•  scale_mtx 

•  translate 

•  mult_4x3mtx 

•  getmatrix 

•  matrix2 

•  mtxcpy 

•  mat_copy 

•  mat_vec_mul 

•  mat_adjugate 

•  mat_transpose 

•  mat_scale 

•  mat_determinant 

•  mat_inverse 

•  vec_mat_mul 

•  make4x3 


507 


BBN  Systems  and  Technologies 


GTIOO  RTSW  CSCI 


2.13.33.1  make_p_nt 

The  make_p_nt  function  converts  a  matrix  to  a  perspective  4x3  matrix.  The  function 
creates  an  identity  matrix,  sets  its  field-of-view  angles  and  offsets  appropriately,  then 
multiplies  it  by  the  original  matrix. 

The  function  call  is  inake_p_nt(itan_fov_i,  itan_fov_j,  hoffset_x,  hoffset_y, 
matrix),  where:  ”  ~ 

itan _fov_i  is  the  inverse  of  the  tangent  of  the  horizontal  field-of-view  angle 
itan  Jov  J  is  the  inverse  of  the  tangent  of  the  vertical  field-of-view  angle 
hoffset  x  is  the  horizontal  offset  of  the  x  coordinate 
hoffset_y  is  the  horizontal  offset  of  the  y  coordinate 
matrix  is  the  matrix  to  be  converted 


Called  By: 

make_ml_overlays 

make_m2_overlays 

Routines  Called: 

id_4x3mtx 

mult_4x3mtx 

Parameters: 

REAL  8 

itan_fov_i 

REAL  8 

itan_fovJ 

REAL  4 

hoffset_x 

REAL  4 

hoffset_y 

REAL_4 

matrix[4][3] 

Returns: 

none 

2.13.33.2  rotate_x_nt 

The  rotate_x_nt  function  rotates  a  4x3  matrix  about  the  X  axis.  The  function  creates  an 
identity  matrix,  rotates  it  accordingly,  then  multiplies  it  by  the  original  matrix. 

The  function  call  is  rotate_x_nt(cos_theta,  sin_theta,  matrix),  where: 

cos  theta  is  the  cosine  of  the  angle  of  rotation 
sin  jheta  is  the  sine  of  the  angle  of  rotation 
matrix  is  the  matrix  to  be  rotated 


Called  By:  flea_init_cig_sw 

gos._model 


Routines  Called:  id_4x3mtx 

mult_4x3mtx 
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Parameters: 

REAL  8 

cos_theta 

REAL  8 

sin_theta 

REAL_4 

matrix[4][3] 

Returns: 

none 

2.13.33.3  rotate_y_nt 

The  rotate_y_nt  function  rotates  a  4x3  matrix  about  the  Y  axis.  The  function  creates  an 
identity  matrix,  rotates  it  accordingly,  then  multiplies  it  by  the  original  matrix. 

The  function  call  is  rotate_y_nt(cos_theta,  sin_theta,  matrix),  where: 

cos  theta  is  the  cosine  of  the  angle  of  rotation 
sinjheta  is  the  sine  of  the  angle  of  rotation 
matrix  is  the  matrix  to  be  rotated 


Called  By: 

flea_init_cig_sw 

gos_model 

Routines  Called: 

id_4x3mtx 

mult_4x3mtx 

Parameters: 

REAL  8 

cos_theta 

REAL  8 

sin_theta 

REAL_4 

matrix[4][3] 

Returns: 

none 

2.13.33.4  rotate_z_nt 

The  rotate_z_nt  function  rotates  a  4x3  matrix  about  the  Z  axis.  The  function  creates  an 
identity  matrix,  rotates  it  accordingly,  then  multiplies  it  by  the  original  matrix. 

The  function  call  is  rotate_z_nt(cos_theta,  sin_theta,  matrix),  where: 

cos  theta  is  the  cosine  of  the  angle  of  rotation 
sin  jheta  is  the  sine  of  the  angle  of  rotation 
matrix  is  the  matrix  to  be  rotated 


Called  By:  flea_init_cig_sw 

flea_simulate_vehicles 

gos_model 
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Routines  Called: 

id_4x3mtx 

mult_4x3mtx 

Parameters: 

REAL  8 

cos_theta 

REAL  8 

sin_theta 

REAL_4 

matrix[4][3] 

Returns: 

none 

2.13.33.5  swap_axis 

The  swap_axis  function  converts  a  matrix's  axes  so  that  the  matrix  conforms  to  the  CIG's 
coordinate  system,  as  follows: 

xview  =  xworld 
yview  =  -zworld 
zview  =  yworld 

The  function  call  is  swap_axis(matrix),  where  matrix  is  the  matrix  to  be  converted. 
swap_axis  first  creates  a  4x3  identity  matrix,  then  sets  this  matrix  to  the  following: 

I  1  0  0  I 

I  0  0  1  I 

10-1  0  ) 

I  0  0  0  I 

swap_axis  then  multiplies  this  matrix  by  the  original  matrix. 


Called  By:  make_cal_matrices 

make_m  1  _overlays 
make_m2_overlays 


Routines  Called:  id_4x3mtx 

mult_4x3mtx 


Parameters:  REAL_4 


matrix[4][3] 


Returns:  none 


2.13.33.6  id_4x3mtx 

The  id_4x3mtx  function  creates  a  4x3  identity  matrix  (positioned  at  the  origin)  for  use  in 
rotating  matrices.  The  identity  matrix  is  as  follows: 
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I  1  0  0  I 

I  0  1  0  I 

I  0  0  1  I 

I  0  0  0  I 

The  function  call  is  id_4x3intx(matrix),  where  matrix  is  the  new  identity  matrix. 


(Med  By: 

flea_init_cig_sw 

flea_simulate_vehicles 

make_cal_matrices 

make_m  1  _overlays 

make_m2_overlays 

make_4)_nt 

rotate_x_nt 

rotate _y_nt 

rotate_z_nt 

scale_mtx 

swap_axis 

translate 

Routines  Called: 

none 

Parameters: 

REAL_4 

matrix[4][3] 

Returns: 

none 

2.13.33.7  scale_mtx 

The  scale_mtx  function  scales  (enlarges,  reduces,  or  skews)  a  4x3  matrix.  The  function 
creates  an  identity  matrix,  applies  the  scaling  factor  to  it,  then  multiplies  it  by  the  original 
matrix. 

The  function  call  is  scale_mtx(scale,  matrix),  where: 

scale  is  the  scaling  factor 
matrix  is  the  matrix  to  be  scaled 

This  function  is  not  currently  used.  (Scaling  is  a  future  system  enhancement.) 


Called  By: 

none 

Routines  Called: 

id_4x3mtx 

mult_4x3mtx 

Parameters: 

REAL  4 

matrix  [4]  [3] 

REAL_4 

scale[3] 
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Returns;  none 


2.13.33.8  translate 

The  translate  function  moves  a  matrix  to  a  new  position  by  adding  a  translation  value  to 
each  of  its  coordinates.  The  function  creates  an  identity  matrix,  translates  its  coordinates, 
then  multiplies  it  by  the  original  matrix. 

The  function  call  is  translate(xval,  yval,  zval,  matrix),  where: 

xval  is  the  amount  to  be  added  to  the  x  coordinate 
yval  is  the  amount  to  be  added  to  the  y  coordinate 
zval  is  the  amount  to  be  added  to  the  z  coordinate 
matrix  is  the  matrix  to  be  translated 

Translation  amounts  are  specified  in  meters. 


Called  By; 

flea_init_cig_sw 

model_mtx 

Routines  Called: 

id_4x3mtx 

mult_4x3mtx 

Parameters; 

REAL  4 

xval 

REAL  4 

yval 

REAL  4 

zval 

REAL_4 

matrix[4][3] 

Returns: 

none 

2.13.33.9  mult_4x3mtx 

The  mult_4x3mtx  function  multiplies  two  4x3  matrices  together.  This  function  is  used  to 
multiply  a  matrix  by  a  rotation  matrix. 

The  function  call  is  mult_4x3mtx(matrix,  matrix_tmp),  where: 

matrix  is  the  rotation  matrix 
matrix  tmp  is  the  matrix  to  be  rotated 


Called  By; 


make_p_nt 

rotate_x_nt 

rotate_y_nt 

rotate_z_nt 

scale_mtx 
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swap_axis 

translate 

Routines  Called: 

none 

Parameters; 

REAL  4 

matrix[4][3] 

REAL_4 

matrix_tmp[4][3] 

Returns: 

none 

2.13.33.10  getmatrix 

The  getmatrix  function  concatenates  a  matrix  with  another  matrix. 

The  function  call  is  getmatrix(matrix,  matrix_tmp),  where; 

matrix  is  the  original  matrix  and  the  result  matrix 

matrix  tmp  is  the  matrix  to  concatenate  with  the  original  matrix 

This  function  is  not  currently  used. 


Called  By: 

none 

Routines  Called: 

none 

Peumieters: 

REAL  4 

matrix  [4]  [3] 

REAL_4 

matrix_tmp[4][3] 

Returns; 

none 

2.13.33.11  matrix2 

The  matrix2  function  concatenates  (multiplies)  two  matrices  to  create  a  third  matrix. 

The  function  call  is  matrix2(matrixa,  matrixb,  matrixc),  where: 

matrixa  and  matrixb  are  the  matrices  to  be  concatenated 
matrixc  is  the  result 

This  function  is  not  currently  used. 

Called  By:  none 
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Routines  Called: 

none 

Parameters: 

REAL  4 

matrixa  [4]  [3] 

REAL  4 

matrixb  [4]  [3] 

REAL_4 

matrixc  [4]  [3] 

Returns: 

none 

2.13.33.12  mtxcpy 

The  intxq)y  function  copies  a  matrix  from  one  memory  location  to  another. 

The  function  call  is  mtxcpy(to_matrix,  from_matrix,  matrix_type),  where: 

to  matrix  is  the  destination  location 
fromjnatrix  is  the  source  location 

matrix  type  is  the  type  of  matrix  (RTS3x3_TYPE,  RTS4x3_TYPE,  or 
ROT2xl_TYPE) 


Called  By: 


concat_mtx 

vpt_cnode_set_matrix 

vpt_update_mtx 


Routines  Called:  none 


Parameters: 


I4P 

I4P 

BYTE 


to_matrix 

from_matrix 

matrix_type 


Returns:  none 


2.13.33.13  mat_copy 

The  mat_copy  function  copies  a  T  matrix  from  one  memory  location  to  another. 

The  function  call  is  mat_copy(src,  dest),  where: 

src  is  the  source  location 
dest  is  the  destination  location 


Called  By: 
Routines  Called: 


mat_transpose 

none 
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Parameters:  T_MATRIX 

T.MATRIX 


src 

dest 


Returns:  none 


2.13.33.14  mat_vec_inul 

The  mat_vec_mul  function  multiplies  a  T  vector  by  a  T  matrix  and  stores  the  result. 

The  function  call  is  mat_vec_mul(in,  v,  result),  where: 

m  is  the  matrix 
V  is  the  vector 
result  is  the  result 

This  function  is  not  currently  used. 


Called  By: 

none 

Routines  Called: 

none 

Parameters: 

T.MATRIX 

m 

T  VECTOR 

V 

T.VECTOR 

result 

Returns: 

none 

2.13.33.15  mat_adjugate 

The  mat_adjugate  function  calculates  the  adjugate  matrix  for  a  given  T  matrix. 

The  function  call  is  inat_adjugate(m,  result),  where: 

m  is  the  original  matrix 
result  is  the  adjugate  matrix 

Called  By:  mat_inverse 

Routines  Called:  none 

Parameters:  T_MATRIX 

T_MATRIX 


m 

result 
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Returns: 


none 


2.13.33.16  inat_transpose 

The  mat_transpose  function  transposes  a  T  matrix  into  a  new  matrix. 

The  function  call  is  mat_transpose(m,  result),  where: 

m  is  the  original  matrix 
result  is  the  transposed  matrix 


Called  By: 

mat_inverse 

Routines  Called: 

mat_copy 

Parameters: 

T  MATRIX 

T.MATRIX 

Returns: 

none 

2.13.33.17  mat_scale 

The  mat_scale  function  scales  (enlarges,  reduces,  or  skews)  a  T  matrix. 


The  function  call  is  mat_scale(mat,  scale  factor,  result),  where: 

mat  is  the  original  matrix 

scale  Jactor  is  the  amount  by  which  to  scale 

result  is  the  scaled  matrix 


Called  By: 

mat_inverse 

Routines  Called: 

none 

Parameters: 

T  MATRIX 

mat 

REAL  8 

scale_factor 

T_MATRIX 

result 

Returns: 

none 
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2.13.33.18  mat_determinant 

The  mat_determinant  function  returns  the  determinant  of  a  T  matrix. 

The  function  call  is  iiiat_deterininant(m),  where  m  is  the  original  matrix. 

Called  By:  mat_inverse 

Routines  Called:  none 

Parameters:  T_MATRIX  m 

Returns:  <matrix  determinant> 


2.13.33.19  mat_in verse 

The  mat_inverse  function  calculates  the  inverse  of  a  given  T  matrix. 

The  function  call  is  mat_inverse(m,  result),  where: 

m  is  the  original  matrix 
result  is  the  inverse  matrix 

To  calculate  the  inverse  of  the  matrix,  mat_inverse  does  the  following: 

1 .  Gets  the  adjugate  matrix. 

2.  Transposes  the  adjugate  matrix. 

3 .  Calculates  the  inverse  of  the  determinant  of  the  transposed  matrix. 

4.  Scales  the  result  of  step  2  by  the  result  of  step  3. 

5 .  Stores  the  result  of  step  4  in  result. 

This  function  is  not  currently  used. 


Called  By:  none 


Routines  Called:  mat_adjugate 

mat_determinant 

mat_scale 

mat_transpose 


m 

result 


Parameters:  T_MATRIX 

T_MATRIX 
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Returns:  none 


2.13.33.20  vec_mat_mul 

The  vec_mat_mul  function  multiplies  a  T  vector  by  a  T  matrix  and  stores  the  result. 

The  function  call  is  vec_mat_mul(v,  m,  result),  where: 

V  is  the  vector 
m  is  the  original  matrix 
result  is  the  new  matrix 


Called  By: 


find_pitch_and_roll 


Routines  Called:  none 


Parameters: 


Returns: 


T_VECrOR 

T_MATRIX 

T_VECrOR 


none 


V 

m 

result 


2.13.33.21  make4x3 

The  make4x3  function  creates  a  4x3  world/hull  matrix  given  its  heading,  pitch, roll,  and  x, 
y,  and  z  coordinates.  It  first  computes  values  for  the  basic  3x3  portion  of  the  matrix,  then 
computes  values  for  the  x,  y,  z  portion  of  the  matrix. 

The  function  call  is  make4x3(cz,  sz,  cx,  sx,  cy,  sy,  x,  y,  z,  matrix),  where: 

cz  is  the  cosine  of  the  z  angle 
sz  is  the  sine  of  the  z  angle 
cx  is  the  cosine  of  the  x  angle 
sx  is  the  sine  of  the  x  angle 
cy  is  the  cosine  of  the  y  angle 
sy  is  the  sine  of  the  y  angle 
X  is  the  X  coordinate 
y  is  the  y  coordinate 
z  is  the  z  coordinate 
matrix  is  the  result  matrix 

Called  By:  concat_mtx 

flea_simulate_vehicles 

flea_update_pos 


Routines  Called:  none 


518 


BBN  Systems  and  Technologies 


GTIOO  RTSW  CSCI 


Parameters: 

REAL  4 

cz 

REAL  4 

sz 

REAL  4 

cx 

REAL  4 

sx 

REAL  4 

cy 

REAL  4 

sy 

REAL  4 

X 

REAL  4 

y 

REAL  4 

z 

T.MATRIX 

matrix 

Returns: 

none 

2.13.34  inodeI_intx.c 

The  model_mtx  function  builds  hull-to-world,  turret-to-hull,  and  gun-to-turret  matrices. 
The  function  call  is  modeI_intx(modnuin),  whem  modnum  is  the  model  number. 

This  function  is  not  currently  used. 


Called  By: 

none 

Routines  Called: 

GLOB 

id_matrix 

prt_mtx 

rotate_x 

rotate_y 

rotate_z 

translate 

Parameters: 

INT_2 

modnum 

Returns: 

none 

2.13.35  mx2_hword.c 

The  functions  in  the  mx2_hword.c  CSU  handle  half-word  messages  exchanges.  These 
function  are  used  for  the  interface  between  the  real-time  software  (specifically,  the  MPV 
Interface  CSC  routines)  and  the  Force  board.  These  functions  are: 

•  mx2_open 

•  mx2_push 

•  mx2_peek 

•  mx2_skip 

•  mx2_error 

•  mx2_hwcopy 
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These  functions  are  also  present  in  and  3re  used  by  the  Force  Processing  CSC  (see  section 
2.18).  The  Routines  Called  and  Called  By  lists  in  this  section  do  not  include  any  Force 
Processing  functions.  Similarly,  the  Routines  Called  and  Called  By  lists  in  section  2.18  do 
not  include  any  real-time  software  functions. 


2.13.35.1  mx2_open 

The  mx2_open  function  initializes  the  message  buffer  given  its  start  address  and  its  size. 
At  the  current  time,  this  function  is  used  only  by  the  Force  Processing  CSC  (see  section 
2.18). 

The  function  call  is  mx2_open(dev_P,  device_size),  where: 

dev  P  is  a  pointer  to  the  message  buffer 
device_size  is  the  size  of  the  message  buffer 

The  function  always  returns  MX_DEVICE_OPENED. 


Called  By:  none 

Routines  Called:  sc_lock 

sc_unlock 

*dev_P 
device_size 

Returns:  MX_DEVICE_OPENED 


Parameters:  MX2_DEVICE 

INT_4 


2.13.35.2  inx2_push 

The  mx2_push  function  pushes  a  message  onto  the  message  buffer.  mx2_push  first 
checks  to  see  if  t^.-  buffer  has  room  for  tiie  message,  then  calls  mx2_hwcopy  to  copy  the 
message  to  the  buffer. 

The  function  call  is  mx2_push(dev_P,  source_address,  message_code, 
message_size),  where: 

dev  P  is  a  pointer  to  the  message  buffer 
source  address  is  the  address  of  the  message 
message  code  is  the  message  type  indicator 
message  size  is  the  size  of  the  message  in  bytes 

The  function  returns  MX_MESSAGE_PUSHED  if  successful.  It  returns 
MX_DEVICE_FULL  if  the  message  buffer  is  already  full. 


Called  By:  mpvideo_boot 
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mpvideo_laser_request_range 

mpvideojoad 

mpvideo_send_req 

mpvideo_set_lut 

mpvideo_set_mode 

mpvideo_set_video 

mpvideo_sim_init 


Routines  Called: 


mx2_hwcopy 
sc_lock 
sc  unlock 


Parametere;  MX2_DEVICE 

WORD 

HWORD 

HWORD 


*dev_P 

source_address 

message_code 

message_size 


Returns:  MX_DEVICE_FULL 

MX_MES  S  AGE_PUSHED 


2.13.35.3  nix2_peek 

The  mx2_peek  function  previews  the  top  message  in  the  message  buffer  and  returns  a 
pointer  to  it. 

The  function  call  is  mx2_peek(dev_P,  message_code,  message_size, 
message_addr),  where: 

dev  P  is  a  pointer  to  the  message  buffer 
message_code  is  a  pointer  to  the  message  type  indicator 
message  size  is  a  pointer  to  the  message  size  in  bytes 
message _addr  is  a  pointer  to  the  message  address 

The  function  returns  MX_MESSAGE_PRE VIEWED  if  successful.  It  returns 
MX_DEVICE_EMPTY  if  the  message  buffer  contains  no  messages. 


Called  By:  mpvideo_boot 

mpvideo_load 
mpvideo_respon  se 


scjock 

sc_unlock 


Routines  Called: 


Parameters: 


MX2_DEVICE 

HWORD 

HWORD 

BYTE 


*dev_P 

*message_code 

*message_size 

*-^message_addr 
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Returns:  MX_DEVICE_EMPTY 

MX_MESSAGE_PREVIEWED 


2.13.35.4  mx2_skip 

The  nix2_skip  function  skips  over  first  message  in  the  message  buffer.  The  skipped 
message  is  flushed  from  the  buffer  and  the  next  message  moves  to  the  head  of  the  queue. 

The  function  call  is  mx2_skip(dev_P),  where  dev_P  is  a  pointer  to  the  message  buffer. 

The  function  returns  MX_MESSAGE_S KIPPED  if  successful.  It  returns 
MX_DEVICE_EMPTY  if  the  message  buffer  contains  no  messages. 


Called  By:  mpvideo_boot 

mpvideo_load 

mpvideo_response 


Routines  Called:  sc_lock 

sc_uniock 


Parameters:  MX2_DEVICE  *dev_P 


Returns:  MX.MESSAGE.SKIPPED 

MX_DEVICE_EMPTY 


2.13.35.5  inx2_error 

The  mx2_error  function  returns  an  ASCII  translation  of  an  error  code,  tor  output  to  the 
operator. 

The  function  call  is  inx2_error(status),  where  status  is  the  error  condition. 

This  function  is  not  currently  used. 


Called  By: 

none 

Routines  Called: 

none 

Parameters; 

WORD 

status 

Returns: 

"DEVICE  CLOSED" 

"DEVICE  TABLE  FULL" 
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"DEVICE  OPENED" 
"DEVICE  BUSY" 

"DEVICE  EMPTY" 
"DEVICE  FULL" 
"MESSAGE  PUSHED" 
"MESSAGE  POPPED" 
"MESSAGE  PREVIEWED" 
"MESSAGE  SKIPPED" 
"UNDEFINED  ERROR" 
"UNDEFINED  RETURN" 


2.13.35.6  mx2_hwcopy 

The  nix2_hwcopy  function  does  a  half-word  block  copy. 

The  function  call  is  mx2_hwcopy(sourcc_P,  destination_P,  byte_count),  where; 

source  P  is  the  source  location 
destination  P  is  the  destination  location 
byte  count  is  the  number  of  bytes  to  be  copied 


Called  By;  mpvideojoad 

mpvideo_response 

mx2_push 


Routines  Called;  none 


Parameters; 

INT  2 

*source_P 

INT  2 

*destination_P 

INT_2 

byte_count 

Returns; 

none 

2.13.36  open_dbase.c 

The  functions  in  the  open_dbase.c  CSU  are  used  to  open  the  terrain  database  and  initialize 
parameters  for  Ballistics.  These  functions  are; 

•  open_dbase 

•  func_msg 


2.13.36.1  open_dbase 

The  open_dbase  function  opens  the  terrain  database  and  initializes  configuration  and  active 
area  memory  parameters  for  Ballistics.  This  function  is  called  when  the  Simulation  Host 
sends  a  MSG_FILE_DESCR  -  DB_SETUP  message. 
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The  function  call  is  open_dbase(pdbase),  where  pdbase  is  a  pointer  to  the  primary 
database  control  block.  ~ 

open_dbase  does  the  following: 

•  Closes  any  open  database. 

•  Opens  the  database  file  specified  in  the  message  or  entered  through  the  keyboard; 
c^s  find_fh  to  find  the  latest  version  of  the  specified  file. 

•  Initializes  the  database  header  data  to  zero. 

•  Reads  the  file  header. 

•  Allocates  memory  for  a  work  area. 

•  Reads  the  tag  record  and  reads  the  applicable  data. 

•  Frees  the  allocated  memory. 

•  Allocates  memory  for  the  terrain  model  address  and  catalog  tables. 

•  Allocates  memory  for  the  special  effects  address  and  catalog  tables. 

•  Initializes  database  variables;  number  of  load  module  blocks  per  side,  grid  space, 
and  number  of  load  modules  on  a  side  of  AAM. 

•  Takes  the  AAM  address  from  the  terrain  database  header  and  ORs  it  with  the  current 
tetTain_addr  which  is  set  up  with  the  AAM  offset  (from  config_database). 

•  Copies  the  terrain_addr  into  the  field-of-view  table  address.  For  a  7000-meter 
viewing  range  (i.e,  with  load  module  blocking  enabled),  divides  this  address  by  2. 

•  Sets  the  remaining  database  variables:  number  of  load  modules  per  side  of  a  load 
module  block,  load  module  width,  load  module  block  width,  active  area  width,  total 
number  of  load  modules  and  load  module  blocks,  etc. 

•  Calculates  the  amount  of  memory  required  for  the  database  and  calls 
extended_ram_available  to  see  if  the  database  is  going  to  fit  in  the  available  RAM. 

•  Initializes  Ballistics  configuration  parameters:  processor  type,  frame  rate,  number  of 
AAM  partitions,  maximum  chord  length,  maximum  model  ra^us,  maximum 
number  of  models,  maximum  number  of  active  rounds,  polygons,  and  bvols,  etc. 

•  Sends  the  configuration  data  to  Ballistics  by  pushing  a  MSG_BO_BAL_CONFIG 
message  onto  the  Ballistics  message  queue. 

•  Initializes  AAM  partition  information  for  Ballistics:  number  of  load  modules  per 
side,  total  number  of  load  modules  in  AAM,  viewing  distance,  grid  width,  AAM 
base  address,  etc. 

•  Sends  the  AAM  partition  parameters  to  Ballistics  by  pushing  a 
MSG_BO_DATABASE_INFO  message  onto  the  Ballistics  message  queue. 

The  terrain  database  is  loaded  into  active  area  memory  by  load_dbase,  which  is  called  by 
db_mcc_setup  after  the  viewf>ort  configuration  tree  is  created. 


Called  By:  db_mcc_setup 


Routines  Called:  exit 

extended_ram_available 

find_fn 

free 

func_msg 

GLOB 

malloc 

mx_push 

printf 

strlen 
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SYSERR 

XCLOSE 

XLSEEK 

XOPEN 

XREAD 


Parameters:  DB_INFO  *pdbase 

Returns:  none 


2.13.36.2  func^msg 

The  func_msg  function  outputs  error  messages  related  to  opening  the  database. 
Specifically,  it  outputs  "OPEN_DBASE"  followed  by  text  supplied  by  open_dbase. 

The  function  call  is  func_iiisg(s),  where  s  is  the  additional  text  to  be  output  to  stdout. 


Called  By: 

open_dbase 

Routines  Called: 

printf 

Parameters: 

BYTE 

Returns: 

none 

2.13.37  open_ded.c 

The  open_ded  function  opens  the  dynamic  elements  database  (DED)  file  and  processes  the 
dynamic  model  list,  changing  the  relative  AAM  addresses  to  absolute  AAM  addresses.  The 
DED  file  name  can  be  specified  by  the  Simulation  Host  in  the  MSG_FILE_DESCR  - 
DB_DED_SETlJP_0  or  DB_DED_SETUP_1  message,  or  it  can  be  entered  through  the 
keyboard. 

For  7000-meter  databases,  additional  memory  can  be  used  to  load  extra  DED  models.  The 
memory  is  allocated  in  two  areas  called  pools:  pool  0  is  the  standard  pool  and  pool  1  is  the 
additional  ("wrap")  pool.  open_ded  calls  the  pool_init  function  to  initialize  the  standard 
pool  and  allocate  the  wrap  pool  if  the  additional  memory  is  available  and  required. 

The  function  call  is  open_ded  (pdbase,  avail_gm,  vme_offset),  where: 

pdbase  is  a  pointer  to  the  primary  database  control  block 

avail_gm  is  the  amount  of  space  in  generic  memory  for  model  information 

vme_offset  is  the  VME  address  offset  to  active  area  memory 

open_ded  is  called  after  the  terrain  database  has  been  loaded  into  active  area  memory. 
open_ded  does  the  following: 
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•  Closes  any  open  DED  file. 

•  Allocates  memory  for  a  scratch  buffer. 

•  Finds  and  opens  tibe  latest  version  of  the  specified  DED  file. 

•  Reads  the  database  header  and  verifies  it  is  valid. 

•  Allocates  memory  for  the  DED  model  address  and  catalog  tables. 

•  Allocates  memory  for  the  DED  special  effects  address  and  catalog  tables. 

•  Initializes  the  file_cut  (the  point  at  which  the  DED  file  will  be  spUt  into  two  pools,  if 
required). 

•  Initializes  the  address  of  the  first  model  to  be  placed  into  the  wrap  pool  to  0. 

•  Reads  in  the  model  directory  entries,  and  updates  the  address  of  ^e  first  model  to 
go  into  the  wrap  pool. 

•  Reads  in  the  effects  directory,  and  updates  the  first  wrap  address  again. 

•  Sets  the  file_cut  value: 

-  If  the  DED  is  too  large  for  standard  generic  memory,  the  file_cut  is  the  first 
wrap  address  (i.e.,  a  model  boundary). 

-  If  the  DED  fits  into  standard  generic  memory,  the  file_cut  is  the  size  of  the 
standard  pool. 

•  Sets  up  the  DED  memory  pools: 

-  Calls  pool_init  to  initialize  the  pool(s). 

-  Outputs  the  pool  boundaries  to  stdout. 

•  Determines  the  memory  address  to  shift  boundary  data  to  (the  last  allocated  pool's 
start  address  plus  the  size  of  DED). 

•  Loads  all  models  into  generic  model  active  area  memory. 

•  Calls  download_bvols  to  download  the  models  and  bounding  volumes  to  Ballistics. 

•  Processes  the  model  directory  entries;  calls  ded_model_trace  to  trace  all  DTP 
commands. 

•  Processes  the  special  effect  directory  entries;  calls  ded_model_trace  to  trace  all  DTP 
commands. 

•  Closes  the  DED  file. 

•  Sets  all  invalid  model  and  effect  address  table  entries  to  the  default  entry.  An 
address  is  considered  invalid  if  it  is  0  or  is  outside  of  both  pools. 

•  ^rees  the  scratch  buffer. 

The  function  returns  0  if  the  DED  file  is  fully  or  partially  loaded.  It  returns  -1  if  no  DED 
file  is  found  or  the  database  header  is  invalid. 


Called  By:  load_dbase 


Routines  Called:  addr_in_pool 

ded_model_trace 

download_bvols 

find_fn 

free 

malloc 

pcwljnit 

printf 

strlen 

XCLOSE 

XLSEEK 

XOPEN 

XREAD 
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Parameters:  DB_INFO 

INT_4 

WORD 


*pdbase; 

avail_gm 

vme_offset 


Returns:  0 

-I 


2.13.38  otherveh_state.c 

The  otherveh_state  function  performs  other  vehicle  model  control.  This  function  is  called 
whenever  the  Simulation  Host  sends  a  MSG_OTHERVEH_STATE  message  to  reposition 
dynamic  vehicles  in  active  area  memory. 

The  function  call  is  otherveh_state(msgp,  pdbase,  vme_offset,  db, 
modeI_num),  where: 

msgp  is  a  pointer  to  the  MSG_OTHERVEH_STATE  message 
pdbase  is  a  pointer  to  the  primary  database  control  block 
vme  offset  is  the  VME  address  offset  to  active  area  memory 
db  is  the  current  double-buffer  base  pointer 
modeljium  is  1  (first  model  this  frame)  or  0  (not  the  first  model) 

otherveh_state  does  the  following: 

•  If  modeljium  is  1,  resets  the  dynamic  component  counters. 

•  Checks  to  see  if  the  vehicle  is  a  tank. 

-  If  it  is  a  tank,  sets  veh_is_tank  to  TRUE;  makes  sure  there  is  enough  room 
for  a  new  tank;  adds  the  tank. 

-  If  it  is  not  a  tank,  sets  veh_is_tank  to  FALSE;  makes  sure  there  is  room  for 
a  new  vehicle;  adds  the  vehicle. 

•  Saves  the  model's  matrix  and  center. 

•  Adds  the  model  to  the  proper  load  module. 

•  Determines  which  list  to  add  the  model  to  (pre-process,  post-process,  or  standard). 

The  function  returns  0  if  successful.  It  returns  E_LIMIT  if  there  is  no  room  for  a  new 
model. 


Called  By:  msg_otherveh_state 


Routines  Called:  FIND  LM 


Parameters:  MSG_OTHERVEH_STATE  *msgp 

DB_INFO  *pdbase 

INT_4  vme_offset 

INT_4  db 

INT_4  model_num 
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Returns:  0 

E_LIMIT 


2.13.39  pretend_veh.c 

The  pretend_veh  function  processes  Gossip  vehicles.  This  function  is  called  at  the  end  of 
every  frame  to  piwess  changes  to  vehicles  that  were  input  by  the  Gossip  user  (via  the 
Model  menu)  during  the  previous  frame.  pretend_veh  adds  and  removes  static  vehicles, 
adds  effects,  and  adds  dynamic  vehicles. 

The  function  call  is  pretend_veh  (imsg,  pretend_sv,  pretend_ef,  pretend_dv, 
remove^sv,  INBUF,  fram^count  ),  where: 

imsg  is  a  pointer  to  the  message  packet  from  the  Simulation  Host 
pretend  sv  is  a  pointer  to  the  static  vehicle  to  be  added 
pretend  ef  is  a  pointer  to  the  effect  to  be  added 
pretend_dv  is  a  pointer  to  the  dynamic  vehicle  to  be  added 
remove  sv  is  a  pointer  to  the  static  vehicle  to  be  removed 
INBUF  is  a  pointer  to  the  incoming  (SIM-to-CIG)  message  buffer 
frame  count  is  the  current  frame  number 

The  changes  to  the  Gossip  vehicles  are  entered  via  menus.  The  gos_model  function  builds 
Simulation  Host-type  messages  for  the  changes  and  places  them  in  the  locations  specified 
in  the  call  (pretend_sv,  pretend_dv,  etc.).  pretend_veh  then  takes  the  messages  and  puts 
them  in  the  next  incoming  message  packet  for  processing. 

Requests  to  remove  static  vehicles  may  also  come  from  the  _rowcol_rd  function. 
_rowcoLrd  pmodically  checks  to  see  that  all  static  vehicles  are  within  viewing  range  of  the 
simulated  vehicle.  If  a  vehicle  is  detected  to  be  out  of  range,  _rowcol_rd  generates  a 
message  to  delete  it  and  places  it  in  the  remove  sv  location,  for  processing  the  next  frame 
by  pretend_veh. 

pretend_veh  returns  TRUE  if  successful,  or  FALSE  if  it  cannot  process  the  message. 


Called  By: 

process_a_msg 

Routines  Called: 

getenv 

printf 

Parameters: 

INT  4 

INT  4 

INT  4 

INT  4 

INT  4 

MSGS  BLK 

INT_4 

**imsg 

**pretend_sv 

**pretend_ef 

**pretend_dv 

**remove  sv 

*INBUF 

frame_count 

Returns: 

1  (TRUE) 

528 


BBN  Systems  and  Technologies 


GTIOORTSW  CSCI 


0  (FALSE) 


2.13.40  rowcol  rd.c 


The  functions  in  the  rowcol_rd.c  CSU  are  responsible  for  determining  whether  new  load 
modules  need  to  be  read  from  the  terrain  database  into  active  area  memory  for  hardware, 
local  terrain,  and  Ballistics  use.  These  functions  are: 

•  rowcol_rd_l 

•  rowcol_rd_2 

•  rowcol_id_3 

•  rowcol_id_4 

•  _rowcol_iti 

•  rowcol_rd_l_cleanup 

•  rowcol_rd_2_cleanup 

•  rowcoljtd_3_cleanup 

•  rowcol_rd_4_cleanup 

•  _rowcol_rd_cleanup 

The  _TDwcol_rd  function  performs  all  database  management,  and  the  _rowcol_rd_cleanup 
function  performs  all  resource  deallocation  at  shutdown.  The  other  functions  simply  call 
_rowcol_id  or  _rowcol_rd_cleanup  for  a  specified  subsystem/active  area  memory. 


The  terrain  database,  which  is  stored  in  the  CIG,  describes  the  entire  terrain  that  can  be 
displayed  in  the  simulation.  It  also  contains  the  graphic  information  used  to  display 
vehicles,  houses,  trees,  hills,  and  other  objects  in  the  terrain. 


The  items  stored  in  the  terrain  database  are  represented  by  connected  polygons  that  are 
three-dimensional  images.  The  polygons  are  grouped  into  compacted  data  structures  such 
as  terrain  grids,  polygon  models,  and  stamp  arrays.  These  structures  are  further  grouped 
into  unique  static  objects  (rivers,  roads,  and  other  features  that  appear  only  once  in  the 
database)  and  generic  models  (houses,  trees,  vehicles,  and  other  features  that  commonly 
recur  in  the  database). 


The  terrain  database  is  divided  into  units  called  load  modules.  One  load  module  contains 
the  instractions  and  data  required  to  process  a  one-half  kilometer  square  area  of  static 
objects.  Each  load  module  contains  all  the  roads,  rivers,  terrains,  buildings,  and  other 
features  within  a  500  by  500  meter  area.  The  load  modules  in  the  terrain  database  are 
organized  in  rows  and  columns.  The  total  size  of  the  database  is  variable. 

Each  load  module  is  divided  into  four  areas  called  grids.  Each  grid  is  a  125-meter  by  125- 
meter  square. 

Active  area  memory  (A  AM)  contains  the  subset  of  the  local  terrain  that  can  be  viewed  and 
interacted  with  at  a  given  point  in  time  by  the  simulation.  The  AAM  stores  an  8K  by  8K 
area  centered  around  the  simulation  vehicle.  This  provides  a  viewing  range  of  3500  meters 
in  each  direction,  with  a  500-meter  buffer  along  each  edge.  The  AAM  contains  256  load 
modules  (16  rows  by  16  columns). 
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16  load  modules 


As  the  simulated  vehicle  moves  toward  an  edge  of  active  area  memory,  _rowcol_rd  brings 
in  new  load  modules  from  the  terrain  database,  overwriting  those  areas  that  the  vehicle  is 
moving  away  from.  The  objective  of  this  process  is  to  keep  the  simulated  vehicle  in  the 
center  of  active  area  memory. 

Active  area  memory  can  be  thought  of  as  a  window  that  moves  over  the  terrain  database. 
As  the  vehicle  travels  east,  for  example,  the  window  must  be  moved  east  to  keep  the 
vehicle  in  the  window's  center.  To  do  this,  _rowcol_rd  determines  what  column  in  the 
database  lies  east  of  the  current  east  bound^  of  AAM.  It  then  reads  part  of  that  column 
(the  16  load  modules  in  the  column  that  lie  between  A  AM's  north  and  south  boundaries) 
into  AAM.  Finally,  it  shifts  the  west  boundary  of  AAM  over  one  column. 

With  very  large  terrain  databases,  load  module  blocking  can  be  enabled.  One  load  module 
block  contains  four  load  modules  (two  rows  by  two  columns).  Therefore,  one  load 
module  block  is  1000  meters  by  1()00  meters,  or  a  one-kilometer  square  area.  Iroad 
module  blocking  increases  the  amount  of  terrain  that  can  be  loaded  into  active  area  memory 
to  16K  by  16K.  It  also  doubles  the  viewing  range  of  the  simulated  vehicle  (from  3500 
meters  to  7000  meters). 


2.13.40.1  rowcoI_rd_l 

The  rowcol_rd_l  function  calls  _rowcol_rd  for  subsystem  0.  rowcoLrd_l  is  invoked  by  a 
mailbox  message  posted  by  init_simulation. 

The  function  call  is  rowcoI_rd_l(). 

Called  By:  none  (task  created  at  initialization  time) 


Routines  Called:  _rowcol_rd 


Parameters:  none 
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Returns:  none 

2.13.40.2  rowcoI_rd_2 

The  rowcol_rd_2  function  calls  _rowcol_rd  for  subsystem  1.  rowcol_rd_2  is  invoked  by  a 
mailbox  message  posted  by  init_simulation,  if  subsystem  1  is  defined. 

The  function  call  is  rowcol  rd  2(). 


Called  By:  none  (task  created  at  initialization  time) 

Routines  Called:  _rowcol_rd 

Parameters:  none 


Returns:  none 

2.13.40.3  rowcoI_rd_3 

The  rowcol_rd_3  function  calls  _rowcol_rd  for  subsystem  2.  rowcol_rd_3  is  invoked  by  a 
mailbox  message  posted  by  init_simulation,  if  subsystem  2  is  defined. 

The  function  call  is  rowcoI_rd_3(). 

Called  By:  none  (task  created  at  initialization  time) 

Routines  Called:  _rowcol_rd 

Parameters:  none 


Returns:  none 

2.13.40.4  rowcoI_rd_4 

The  rowcol_rd_4  function  calls  _rowcol_rd  for  subsystem  3.  rowcol_rd_4  is  invoked  by  a 
mailbox  message  posted  by  init_simulation,  if  subsystem  3  is  defined. 

The  function  call  is  rowcol_rd_4(). 

Called  By:  none  (task  created  at  initialization  time) 
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Routines  Called;  _rowcol_rd 

Parameters:  none 

Returns:  none 


2.13.40.5  _rowcol_rd 

The  _rowcol_rd  function  determines  whether  a  new  row  or  column  of  the  terrain  database 
needs  to  be  read  into  active  area  memory.  This  task  is  invoked  by  the  rowcol_rd_* 
functions  when  a  message  is  posted  to  the  database  management  mailbox.  The  primary 
function  of  _rowcol_rd  is  to  keep  the  simulated  vehicle  in  the  center  of  active  area  memory. 

The  function  call  is  _rowcol_rd(pdbase),  where  pdbase  is  a  pointer  to  the  primary 
database  control  block.  ~ 

When  a  message  is  posted  to  its  mailbox,  _rowcol_rd  does  the  following: 

•  Initializes  direction  offsets. 

•  Calls  poll_shutdown  to  see  if  a  system  shutdown  has  been  requested. 

•  Checks  to  see  if  reading_lm  is  TRUE,  indicating  that  load  modules  were  read  in 
during  the  last  iteration: 

-  If  TRUE,  sets  it  to  FALSE. 

If  FALSE,  posts  a  messages  and  waits  to  be  woken  up  again. 

•  Pushes  a  MSG.  .B0_AAM_S W_CORNER  message  onto  the  Ballistics  message 
queue  to  tell  Ballistics  where  the  southwest  comer  of  active  area  memory  is. 

•  Checks  to  see  if  the  simulated  vehicle  is  out  of  viewing  range  of  AAM  (i.e.,  is 
beyond  an  AAM  boundary  by  a  distance  of  more  than  one-half  AAM  width).  If 
yes: 

-  Sets  warp_in_progress  and  reading_lm  to  TRUE. 

Calls  load_modules  to  reload  all  of  AAM  from  the  terrain  database. 

Sets  warp_in_progress  to  FALSE. 

•  Checks  to  see  if  the  simulated  vehicle  is  inside  AAM,  or  outside  but  within  viewing 
range  of  it.  If  yes; 

-  Compares  the  coordinates  of  the  vehicle's  centroid  to  the  center  of  AAM. 

If  the  vehicle  is  detected  to  be  off-center,  sets  reading_lm  to  TRUE,  then 
calls  whatdirptr  and  getside  to  load  a  new  row  or  column  in  the  needed 
direction.  For  example,  if  the  vehicle  is  detected  to  be  too  far  away  ^m  the 
west  boundary  (i.e.,  is  east  of  AAM  center),  a  column  is  added  to  the  east 
side  and  deleted  from  the  west.  This  has  the  effect  of  shifting  all  of  AAM 
east  by  one  column. 

Updates  the  applicable  database  data  variables  to  reflect  the  change  to  AAM 
boundaries. 

•  Checks  to  make  sure  that  all  static  vehicles  are  within  the  active  area.  If  any  static 
vehicle  is  found  outside  the  simulated  vehicle's  viewing  range: 

Generates  a  MSG_STATICVEH_REM  message  (with  the  vehicle  type  set 
to  0). 

Puts  the  message  in  global  memory  for  processing  (by  pretend_veh)  during 
the  next  frame. 
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Called  By:  rowcol_rd_l 

rowcol_rd_2 

rowcol_rd_3 

rowcol_rd_4 


Routines  Called: 


getside 

GLOB 

load_modules 

mx_push 

poll_shutdown 

printf 

rt_pend 

rt_post 

sc_delay 

whatdirptr 


Parameters:  DB_INFO  *pdbase 

Returns:  none 


2.13.40.6  rowcoI_rd_l_cleanup 

The  rowcoLrd_l_cleanup  function  calls  _rowcol_rd_cleanup  for  subsystem  0.  This 
function  is  called  when  a  system  shutdown  is  requested  by  the  Gossip  user.  The  function 
is  called  via  the  *task_cleanup  function  pointer,  which  points  to  the  cleanup  routine's  name 
in  the  task  table. 

The  function  call  is  rowcol_rd_l_cIeanup(). 


Called  By:  polLshutdown  (through  *task_cleanup) 


Routines  Called:  _rowcol_rd_cleanup 


Parameters:  none 


Returns:  _rowcol_rd_cleanup(  &db_control[0] ) 


2.13.40.7  rowcoI_rd_2_cleanup 

The  rowcoLrd_2_cleanup  function  calls  _rowcol_rd_cleanup  for  subsystem  1 .  This 
function  is  called  when  a  system  shutdown  is  requested  by  the  Gossip  user.  The  function 
is  called  via  the  *task_cleanup  function  pointer,  which  points  to  the  cleanup  routine's  name 
in  the  task  table. 
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The  function  call  is  rowcol_rd_2_cleanup{). 

Called  By:  poll_shutdown  (through  *task_cleanup) 

Routines  Called:  _rowcol_rd_cleanup 

Parameters:  none 

Returns:  _rowcol_rd_cleanup(  &db_control[l] ) 

2.13.40.8  rowcoI_rd_3_cleanup 

The  rowcol_rd_3_cleanup  function  calls  _rowcol_rd_cleanup  for  subsystem  2.  This 
function  is  called  when  a  system  shutdown  is  requested  by  the  Gossip  user.  The  function 
is  called  via  the  *task_cleanup  function  pointer,  which  points  to  the  cleanup  routine's  name 
in  the  task  table. 

The  function  call  is  rowcoI_rd_3_cIeanup(). 

Called  By:  poll_shutdown  (through  *task_cleanup) 

Routines  Called:  _rowcol_rd_cleanup 

Parameters:  none 

Returns:  _rowcol_rd_cleanup(  &db_control[2] ) 

2.13.40.9  rowcoI_rd_4_cleanup 

The  rowcol_rd_4_cleanup  function  calls  _rowcol_rd_cleanup  for  subsystem  3.  This 
function  is  called  when  a  system  shutdown  is  requested  by  the  Gossip  user.  The  function 
is  called  via  the  *task_cleanup  function  pointer,  which  points  to  the  cleanup  routine's  name 
in  the  task  table. 

The  function  call  is  rowcol_rd_4_cleanup(). 

Called  By:  polLshutdown  (thiough  *task_cleanup) 

Routines  Called:  _roucol_rd_cleanup 
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Parameters:  none 


Returns:  _rowcol_rd_cleanup(  &db_control[3] ) 


2.13.40.10  _rowcol_rd_cIeanup 

The  _rowcol_rd_cleanup  function  deallocates  the  resources  allocated  to  the  rowcol_rd  task 
for  a  specified  backend.  This  function  is  called  when  a  system  shutdown  is  requested  by 
the  Gossip  user. 

The  function  call  is  rowcol  rd_cleanup(pdbase),  where  pdbase  is  the  primary 
database  control  bloc^  for  the"&ackend. 

The  function  returns  1  if  successful,  or  0  if  an  error  occurred. 

Note:  This  function  is  not  yet  implemented.  At  the  current  time,  the 
function  simply  returns  al  if  called. 


Called  By:  rowcol_rd_l_cleanup 

rowcol_rd_2_cleanup 
rowcol_rd_3_cleanup 
rowcol_rd_4_cleanup 


Routines  Called:  none 


Parameters:  DB_INFO  *pdbase 

Returns:  0 

1 


2.13.41  rt_mailbox.c 

The  rt_mailbox.c  CSU  contains  special  intertask  mailbox  functions  used  by  the  real-time 
software  tasks. 

The  functions  in  this  CSU  are: 

•  rtjjend 

•  rt_post 

•  n_accept 


2.13.41.1  rt_pend 

The  rt_pend  function  waits  for  a  message  to  be  posted  to  a  specific  mailbox. 
The  function  call  is  rt_pend(mboxp,  timeout,  errp),  where: 
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mboxp  is  a  pointer  to  the  intertask  mailbox 

timeout  is  the  amount  of  time  to  wait  for  the  message  before  timing  out;  0  =  use  default 
timeout 

errp  is  the  error  pointer 
rt_pend  does  the  following: 

•  Calls  sc_pend  to  wait  for  the  specified  mailbox  message.  The  timeout  is  set  to  the 
timeout  specified  in  the  call  or  to  a  default  value. 

•  Calls  polLshutdown  to  see  if  a  system  shutdown  has  been  initiated. 

The  function  returns  the  value  returned  from  sc_pend  as  result. 


Called  By:  _pend_on_frame_interrupt 

_rowcol_rd 


bx_task 

exchange_flea_data 

flea 

flea_host_if 

host_if_debug 

local_terrain 

msg_end 

Routines  Called: 

polLshutdown 

sc_pend 

Parameters: 

char 

long 

int* 

**  mboxp 

timeout 

errp 

Returns: 

result 

2.13.41.2  rt_post 

The  rt_post  function  posts  a  message  to  a  specified  intertask  mailbox  by  calling  sc_post. 

The  function  call  is  rt_post(mboxp,  msg,  errp),  where: 

mboxp  is  a  pointer  to  the  mailbox 
msg  is  a  pointer  to  the  message 
errp  is  the  error  pointer 


_rowcol_rd 

bx_task 

locaLterrain 

scratch_flea 


Called  By: 
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Routines  Called: 

sc_post 

Parameters: 

char 

**mboxp 

char 

*msg 

int 

♦errp 

Returns: 

none 

2.13.41.3  rt_accept 

The  rt_accept  function  clears  any  stray  messages  from  a  specified  mailbox  by  calling 
sc_accept. 

The  function  call  is  rt_accept(mboxp,  errp),  where: 

mboxp  is  a  pointer  to  the  mailbox 
errp  is  the  error  pointer 

The  function  returns  the  value  returned  by  sc_accept. 

This  function  is  not  currently  used. 

Called  By:  none 

Routines  Called:  sc_accept 

Parameters:  char 

int 


**  mboxp 
*errp 


Returns: 


sc_accept(mboxp,  errp) 


2.13.42  rtMnit.c 

The  functions  in  the  rtt_init.c  CSU  are  used  to  parse  the  command  line  entered  by  the  user 
at  startup,  and  to  initialize  the  system.  These  functions  arc: 

•  initialize_defaults 

•  initialize 


2.13.42.1  initialize_defaults 

The  initialize_defaults  function  initializes  various  system  variables  to  their  default  values. 
Currently,  these  variables  arc  tlic  CIG-SIM  frame  rate  and  the  boolean  that  controls  single- 
step  mode. 
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The  function  call  is  initialize  defaults(). 


Called  By: 

initialize 

Routines  Called: 

none 

Parameters: 

none 

Returns: 

none 

2.13.42.2  initialize 

The  initialize  function  parses  the  command  line  entered  by  the  user  to  start  up  the  system. 
Command  line  arguments  are  used  to  select  the  correct  network  interface  as  well  as  to 
toggle  certain  types  of  processing  on  and  off.  initialize  then  calls  other  functions  to 
initialize  the  system  in  the  desir^  manner. 

The  arguments  that  can  be  entered  on  the  initialize  command  line  are  listed  below,  along 
with  the  variable(s)  set  if  that  argument  is  specified. 


Switch 

Description 

Varlable(s) 

A 

AGPT  mode  -  host  via  socket  to  simnet 
server 

agpt_mode 

a 

Aerial  terrain  feedback  shutoff  (altitude 
above  ground) 

feedback_shutoff_G 

b 

Ballistics  processing  disabled 

ball_disable_wantcd 

c 

Constrain  database  to  initial  load 

database_disable_wanicd 

d 

Download  texture  maps  to  IPPTs 

esifa_lciad_wanted 

e 

Ethernet  mode 

enct_mode_G 

f 

Flea  mode 

flea_mode_G 

h 

Help 

none 

m 

MPV  mode 

mpv_mode_local 

P 

Set  CIG-SIM  packet  exchange  size 

drl  lin_pkt_size,  drl  loutj5kt_sizc 

s 

Set  speed  (frame  rate  in  Hz) 

&ame_rate 

S 

STG  slaved 

slave^stg 

t 

Set  local  terrain  chunk  size  and  interval 

lt_chunk_size,  lt_interval 

V 

Verbose 

verbose_G 

X 

Socket  interface  mode 

l(xa)_sncket  name 

z 

SCSI  mode 

scsi_mode_local 
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initialize  does  the  following: 

•  Calls  initiali2e_defaults  to  initialize  various  system  parameters. 

•  Calls  clparse  to  verify  that  the  command  line  is  valid. 

•  Calls  host_if_buffer_init  to  reset  the  INBUF  and  OUTBUF  buffers. 

•  Calls  host_init_packet_sizes  to  initialize  the  CIG-SIM  exchange  packet  sizes. 

•  Initializes  the  host  interface  based  on  the  command  line,  as  follows: 

-  If  Ethernet  mode  is  requested  ("e”  argument),  calls  init_enet_interface. 

If  flea  mode  is  requested,  ("f  ’  argument)  calls  init_flea_interface. 

-  If  MPV  mode  is  requested  ("m"  argument),  calls  init_mpv_interface. 

-  If  SCSI  mode  is  requested  ("z"  argument),  calls  init_scsi_interface. 

-  If  socket  mode  is  requested  ("x"  argument),  calls  init_socket_interface. 

-  If  DRl  1  mode  is  requested  (default),  calls  init_drl  l_interface. 

•  Opens  and  parses  the  subsys.cfg  file: 

Calls  init_subsys_parser  to  initialize  the  parser  used  to  read  the  file. 

-  Calls  fopen  to  open  the  file. 

Calls  set_token_file  and  parse_subsys_file  to  read  the  file. 

-  Calls  fclose  to  close  the  file. 

-  Calls  the  get_*  functions  to  retrieve  the  specified  file  names,  and  outputs 
them  to  stdout. 

•  Calls  sys_control_init  to  initialize  the  frame  rate  in  the  EVC  board. 

•  For  subsystem  0  (AAM 1 ): 

-  Calls  backend_setup  to  configure  the  backend. 

-  Calls  find_fn  to  find  the  forcetask  file  ("forceO"). 

-  Calls  mpvideo_boot  to  start  the  MPV. 

Calls  mpvideo_load  to  load  the  3-D  and  final  lookup  tables,  the  2-D  overlay 
file,  and  the  2-D  task. 

•  If  subsystem  1  (AAM2)  exists; 

-  Calls  backend_setup  to  configure  the  backend. 

-  Calls  find_fn  to  find  the  forcetask  file  ("force  1 "). 

-  Calls  mpvideo_boot  to  start  the  MPV. 

Calls  mpvideo_load  to  load  the  3-D  and  final  lookup  tables,  the  2-D  overlay 
file,  and  the  2-D  task. 

•  Calls  sys_control_init  to  initialize  the  frame  rate  in  the  EVC  board. 

•  Calls  sys_slave_sync  to  synchronize  the  frame  interval  with  an  external  master 
CIG,  or  sys_master_sync  to  set  up  the  local  CIG  as  the  master. 

•  Calls  vpt_tree_init  to  initialize  the  viewport  configuration  tree. 

The  function  exits  with  1  if  an  error  was  detected  on  the  command  line,  or  if  mpvideojoad 
could  not  load  a  required  file. 


CaUed  By:  main  (in  rtt.c) 


Routines  Called:  backend_setup 

clparse 
exit 
fclose 
find_fn 
fopen 

get_3d_lut_name 

get_color_config_name 

get_data_2d_name 
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get_database_name 

get_ded_name 

get_esifa_name 

get_final_lut_name 

host_if_buffer_init 

host_init_packet_sizes 

init_drl  l_interface 

init_enet_interface 

init_flea_interface 

init_mpv_interface 

init_scsi_interface 

imt_socket_interface 

imt_subsys_parser 

initialize_defaults 

mpvideo_boot 

mpvideo_load 

parse_subsys_file 

printf 

set_token_file 

strcpy 

strlen 

sys_control_init 

sys_master_sync 

sys_slave_sync 

vpt_tree_init 


Parameters:  int 

char 


argc 

*argv[] 


Returns:  none 


2.13.43  simulation.c 

The  functions  in  the  simulation.c  CSU  form  the  message  handler  for  the  real-time 
simulation  control  of  the  CIG  hardware  and  communications  with  the  Simulation  Host. 
These  functions  are: 


•  simulation 

•  process_a_msg 

•  syserr 


2.13.43.1  simulation 

The  simulation  function  calls  other  functions  to  initialize  all  simulation  variables  and 
process  the  messages  received  from  the  Simulation  Host.  This  function  is  called  when  the 
Simulation  Host  sends  a  MSG_CIG_CTL  message  with  the  new  state  set  to 
C_SIMULATION  or  C_MCC_SIMUL. 

The  function  call  is  simulation(simstate),  where  simstate  is  the  new  state  of  the  CIG 
system  (C.SIMULATION  or  C_MCC_SIMUL). 
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simulation  does  the  following: 

•  Calls  mit_simulation  to  initialize  various  simulation  variables  and  table  pointers, 
notify  the  backend  to  prepare  for  a  simulation,  initiate  database  management  and 
database  feedback,  and  enable  system  interrupts. 

•  Calls  polLshutdown  to  see  if  a  system  shutdown  has  been  requested. 

•  Makes  sure  the  packet  size  has  not  been  exceeded. 

•  Tests  to  see  if  an  interrupt  has  occurred  by  looking  for  a  SIMULATION_MB 
mailbox  message.  If  so,  flushes  the  frame  by  calling  sc_accept.  This  step  is 
skipped  if  the  simulation  is  running  under  Flea. 

•  Calls  |jrocess_a_msg  to  process  each  runtime  message  received  from  the  Simulation 
Host. 

•  Calls  stop_watch  to  read  and  stop  the  timer. 


Called  By: 


db_mcc_setup 


Routines  Called:  asm 

GLOB 

init_simulation 

polLshutdown 

printf 

process_a_msg 

sc_accept 

stop_watch 

syserr 


Parameters:  INT_2  simstate 

Returns:  none 


2.13.43.2  process_a_msg 

The  process_a_msg  function  handles  all  messages  received  by  the  Simulation  Host  during 
a  simulation.  This  function  is  called  when  the  CIG  is  ready  to  start  processing  messages. 

The  function  call  is  process_a_msg(curr_siin_buf,  pdbase,  pdynl,  ptanks, 
pmodels,  peffects),  where: 

currjsimjbirf  is  the  double  buffer  the  real-time  software  is  currently  loading 
pdbase  is  a  pointer  to  the  primary  database  control  block 

pdynl  is  a  pointer  to  the  structure  containing  the  current  state  of  all  dynamic  models 

ptanks  is  the  starting  address  of  the  tanks  table 

pmodels  is  the  starting  address  of  the  dynamic  models  table 

peffects  is  the  starting  address  of  the  dynamic  effects  table 

For  each  message  is  receives,  process_a_msg  does  the  following: 
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Calls  cigsiinio_msg_in  to  write  the  message  to  a  buffer  (if  message  recording  or 
debug  (hsplay  is  enabled). 

Processes  the  message  according  to  its  type  (see  table  below). 


In  most  cases,  process_a_msg  simply  calls  a  Message  Interface  (msg_*)  function  to  handle 
the  message.  For  messages  Aat  are  to  be  forwarded  to  Ballistics,  process_a_msg  pushes 
the  message  onto  the  Ballistics  message  queue  or  calls  a  sim_bal_*  routine. 

The  following  table  summarizes  the  processing  performed  by  process_a_msg  in  response 
to  each  valid  message  type  it  receives  from  the  Simulation  Host.  The  first  column  lists  the 
messages  in  alphabetic^  order.  The  second  column  briefly  describes  the  purpose  of  the 
message  (in  itiics),  then  lists  the  major  steps  performed  by  process_a_msg  to  process  that 
message. 


Message  from  SIM  Host 

Processing  by  process_a  msg 

MSG.IROTATION 

Updates  a  single  rotation  of  an  hprxyzs  matrix. 

Calls  msg_lroialion. 

MSG_3ROTATIONS 

Updates  the  rotation  portion  of  an  hprxyzs  matrix. 

Calls  insg_3rotations. 

MSG_ADD_TRAJ_TABLE 

Defines  a  new  trajectory  table. 

Pushes  MSG_BO_ADD_TRAJ_TABLE  message  onto 
Ballistics  message  queue. 

MSG.AGL.SETUP 

Toggles  AGL  processing  on  and  off. 

Sets  agLwanted  in  global  memory. 

MSG_AMMO_DEFINE 

Define  ammunition  maps. 

Loads  the  specified  ammunition  maps  into  memory. 

MSG_CALIBRATION_IMAGE 

Displays  offset  image,  color  image,  or  BBN  logo. 

Calls  msg_calibration_image. 

MSG_CANCEL_ROUND 

Tells  Ballistics  to  cancel  a  fired  round. 

Pushes  MSG_B0_CANCEL_ROUND  message  onto 
Ballistics  message  queue. 

MSG_aG_CTL 

Causes  a  transition  to  another  performance  state. 

Calls  msg_cig_cil. 

MSG_CLOUD_STATE 

Positions  cloud  models  at  a  specified  altitude. 

Calls  cloud_update. 

MSG_DELETE_TRAJ_TABLE 

Tells  Ballistics  to  delete  a  downloaded  trajectory  table. 
Pushes  MSG_BO_DELETE_TRAJ_TABLE  message 
onto  Ballistics  message  queue. 

MSG.DRl  1_PKT_S1ZE 

Specks  exchange  packet  parameters. 

Calls  msg_drl  l_plrt_size. 

MSG.END 

Signals  end  of  packet  buffer. 

Calls  pretend_veh;  calls  msg_end. 

MSG_GUN_OVERLAY 

Changes  gun/gunner  overlays. 

Calls  ml_gun_overlay  or  m2 _gun_overlay,  based  on 
type  in  message. 

MSG_HPRXYZS_MATRIX 

Updates  a  configuration  node’s  matrix. 

Calls  msg_hprxyzs_mauix. 

MSG_LT_STATE 

Changes  the  local  terrain  frame  interval  and  chunk  size. 
Calls  lt statc. 
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MSG_OTHERVEH_STATE 

Describes  the  state  of  all  dynamic  vehicles  in  the  terrain. 
Calls  msg_othCTveh„state. 

MSG_PASS_ON 

Provides  data  to  be  passed  on  to  a  specific  subsystem  in 
the  CIG  (e.g.,2-D  overlay  processor). 

Calls  nisg_pass_on. 

MSG_PPM_DISPLAY_MODE 

Changes  PPM  display  modes. 

Calls  msg_ppm_display_inode. 

MSG_PPM_DISPLAY_OFFSET 

Changes  PPM  display  offsets. 

Calls  msp  ppm  display  offset. 

MSG_PPM_PIXEL_LOCATION 

Sets  a  new  PPM  pixel  location. 

Calls  tnsg_ppm_pixel_location. 

MSG_PPM_PIXEL_STATE 

Turns  PPM  pixel  processing  on  or  off. 

Calls  msg_ppm_pixel_state. 

MSG_PROCESS_CHORD 

Tells  Ballistics  to  process  a  chord. 

Pushes  MSG_BO_PROCESS_CHORD  message  onto 
Ballistics  message  queue. 

MSG_PROCESS_ROUND 

Tells  Ballistics  to  process  a  fired  round. 

Pushes  MSG_B0_PRCXrESS_ROUND  message  onto 
Ballistics  message  queue. 

MSG_PROCESS_ROUND48 

Tells  Ballistics  to  process  a  fired  round. 

Calls  msg_process_round48. 

MSG_REQUEST_LASER_RANGE 

Asks  for  pixel  depth  for  i,  j  position  on  screen. 

Calls  msg_laser_request_range. 

MSG_REQUEST_POINT_INFO 

Asks  for  terrain  characteristics  at  a  specific  point  in  the 
viewing  range. 

Calls  sim_bal_req_pt_info. 

MSG_ROT2xl_MATRIX 

Updates  a  configuration  node's  matrix. 

Calls  msg_rot2xl_matrix. 

MSG_ROUND_FTRED 

Tells  Ballistics  that  a  round  has  been  fired. 

Pushes  MSG_BO_ROUND_FIRED  message  onto 
Ballistics  message  queue;  if  rtsw.timing  Bag  is  enabled, 
computes  processing  time  for  message  and  updates 
worst  time  if  applicable. 

MSG_RTS4x3_MATRIX 

Updates  a  configuration  node's  matrix. 

Calls  msg_rts4x3_matrix. 

MSG.SCALE 

Updates  the  scale  portion  of  an  hprxyzs  matrix. 

Calls  msg_scale. 

MSG_SHOW_EFFECT 

Used  to  show  the  effect  of  an  impact  on  terrain  or  a 
vehicle. 

Calls  msg_show_effecL 

MSG_SIO_WRITE 

Writes  data  to  a  serial  device. 

Calls  sio_write. 

MSG_STATICVEH_REM 

Removes  a  static  vehicle  from  the  local  terrain. 

Calls  msg_staticveh_rem. 

MSG_STATICVEH_STATE 

Adds  a  static  vehicle  to  the  local  terrain. 

Calls  msg_staticveh_state. 

MSG_SUBSYS_MODE 

Changes  subsystem-specific  parameters  (e.g.,  color 
table,  fade  value,  calibration  mode). 

Calls  msg_subsys_mode. 
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MSG_TF_INIT_HDR 

Controls  the  way  the  CIG  builds  a  terrain  feedback 
message. 

Pushes  MSG_BO_TF_INIT_HDR  message  onto 

Ballistics  message  queue;  if  "own"  vehicle,  sets  flags 
and  frequency  variables. 

MSG_TF_INIT_PT 

Species  a  point  for  which  terrain  feedback  is  desired. 
Pushes  MSG_BO_TF_INIT_PT  message  onto  Ballistics 
message  queue. 

MSG_TF_STATE 

Disableslerutbles  terrain  feedback  processing:  changes 
frequency  of  own  vehicle  feedback. 

Pu^es  MSG_BO_TF_STATE  message  onto  Ballistics 
message  queue;  if  message  is  for  "own"  vehicle,  sets 
flags  and  frequency  accordingly. 

MSG_TF_VEHICIJE_POS 

Provides  new  position  of  vehicle  for  which  terrain 
feedback  data  is  being  collected. 

Pushes  MSG_BO_TF_VEHICLE_POS  message  onto 
Ballistics  message  queue. 

MSG_TRAJ_CHORD 

Used for  chords  that  represent  trajectories. 

Calls  sim_bal_traj_chord;  if  rtsw_timing  flag  is 
enabled,  computes  processing  time  for  message  and 
updates  worst  time  if  an>licable. 

MSG_TRAJ_ENTRY 

Downloads  an  entry  to  a  trajectory  table. 

Pushes  MSG_BO_TRAJ_ENTRY  message  onto 

Ballistics  message  queue. 

MSG.TRANSLATION 

Updates  the  translation  portion  of  an  hprxyzs  matrix. 
Calls  msg_translation. 

MSG_VIEW_FLAGS 

Updates  system  view  flags  (e.g.,  onloff,  FUR,  DTV) 
cmdior  branch  values. 

Calls  msg_view_flags. 

MSG_VIEW_MAGNinCATION 

Changes  viewport's  field  of-view  andlor  level  of  detail. 
Calls  msg_view_magnification. 

MSG_VffiWPORT_UPDATE 

Modifies  viewport  parameters. 

Calls  msg_viewport_update. 

Called  By:  simulation 


Routines  Called: 


asm 

cigsimio_msg_in 

cloud_update 


GLOB 

lt_state 

m  1  _gun_overlay 
m2_gun_overlay 
msg_l  rotation 
msg_3rotations 
msg_cali  bration_image 
msg_cig_ctl 
msg_drl  l_pk:t_size 
msg_end 

msg_hprxyzs_matrix 
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msg_laser_request_range 

msg_otherveh_state 

msg_pass_on 

msg_ppm_display_mode 

msg_ppm_display_offset 

msg_ppm_pixel_lcx:ation 

msg_ppm_pixel_state 

insg_process_round48 

msg_rot2x  1  _matrix 

msg_rts4x3_matrix 

msg_scale 

msg_show_effect 

msg_staticveh_rcm 

msg_staticveh_state 

msg_subsys_niode 

nisg_translation 

msg_view_flags 

msg_view_magnific'*don 

msg_viewport_up  late 

mx_push 

pretend_veh 

printf  (in  debug  mode  only) 

read_watch 

sim_bal_req_pt_info 

sim_bal_traj_chord 

sio_write 

syserr 


Parameters; 


INT_2 

DB.INFO 

INT_4 

TANK 

OMODEL 

SHOW_EFF 


*curr_sim_buf 

*pdbase 

*’''pdynl 

**ptanks 

**pmode]s 

**peffects 


Returns:  none 


2.13.43.3  syserr 

The  syserr  function  is  used  to  generate  a  MSG_SYS_ERROR  message  for  return  to  the 
Simulation  Host.  This  function  is  called  if  an  error  is  detected  in  a  SEM-to-CIG  message 
packet  (e.g.,  packet  length  overrun  or  illegal  message  type),  or  a  function  requested  by  the 
Simulation  Host  could  not  be  performed  (e.g.,  configuration  tree  initialization  error  or  laser 
range  request  failure). 

The  function  call  is  syserr(error,  state),  where: 

error  is  the  error  that  was  detected 
state  is  the  current  state  of  the  CIG 
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The  MSG_SYS_ERROR  message  is  included  in  every  CIG-to-SIM  message  packet,  even 
if  no  error  has  been  detected.  The  syserr  function  is  called  only  if  an  error  occurs. 


Called  By: 

_pend_on_frame_interrupt 

cig_config 

exchange_enet_data 

exchange_enet_data_sim 

lt_state 

m  1  _gun_overlay 
m2_gun_overlay 
mpvideo_response 
msg_cig_ctl 

msg_laser_request_range 

msg_pass_on 

msg_subsys_mode 

msg_viewport_update 

process_a_msg 

simulation 

Routines  Called: 

none 

Parameters: 

INT  2 

INT_2 

Returns: 

none 

error 

state 


2.13.44  staticvehremove.c 

The  staticveh_remove  function  deletes  a  static  vehicle  from  the  simulation  environment. 
This  function  is  called  (once  per  backend)  whenever  the  Simulation  Host  sends  a 
MSG_STATICVEH_REM  message. 

The  function  call  is  staticveh_remove(msgp,  pdbase,  vme  offset,  backend), 
where: 

msgp  is  a  pointer  to  the  MSG_STATICVEH_REM  message 
pdbase  is  a  pointer  to  the  primary  database  conyol  block 
vmejoffset  is  the  VME  address  offset  to  active  area  memory 
backend  is  the  backend  id 

staticveh_remove  does  the  following; 

•  Uses  FIND_LM  to  determine  the  load  module  that  contains  the  vehicle,  based  on  its 
coordinates. 

•  Determines  which  list  to  remove  the  model  from  (pre-process,  post-process,  or 
standard  process). 

•  If  the  backend  is  0,  calls  sim_bal__static_rem  to  notify  Ballistics  to  remove  the 
vehicle  from  its  tables. 
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•  Deletes  the  vehicle  from  the  applicable  table,  and  decrements  all  associated 
counters. 

•  Removes  any  special  effects  associated  with  the  vehicle. 


Called  By:  msg_staticveh_rem 


Routines  Called:  FIND_LM 

panic 

sim_bal_static_rem 


Parameters:  MSG_STAT1CVEH_REM  *msgp 

DB_INFO  ♦pdbase 

INT_4  vme_offset 

INT_4  backend 


Returns:  none 


2.13.45  staticveh_state.c 

The  staticveh_state  function  adds  a  static  vehicle  to  the  simulation  environment.  This 
function  is  called  (once  per  backend)  whenever  the  Simulation  Host  sends  a 
MSG_STATICVEH_STATE  message. 

The  function  call  is  staticveh_state(msgp,  pdbase,  vme_offset,  backend),  where: 

msgp  is  a  pointer  to  the  MSG_STATICVEH_  STATE  message 
pdbase  is  a  pointer  to  the  primary  database  control  block 
vme_offset  is  the  VME  address  offset  to  active  area  memory 
backend  is  the  backend  id 

staticveh_state  does  the  following: 

•  Determines  whether  the  vehicle  is  a  tank;  sets  the  veh_is_tank  flag  appropriately. 

•  Adds  the  vehicle  to  the  appropriate  table  (tank  or  model). 

•  Increments  the  applicable  model  counter. 

•  Saves  the  model's  matrix  and  center. 

•  Uses  FIND_LM  to  determine  the  load  module  that  contains  the  vehicle,  based  on  its 
coordinates. 

•  Adds  the  vehicle  to  the  appropriate  load  module  table. 

•  Adds  the  vehicle  to  the  appropriate  model  list  (pre-process,  post-process,  or 
standard  process). 

•  If  the  backend  is  0,  calls  sim_bal_static_add  to  notify  Ballistics  to  add  the  vehicle  to 
its  tables. 

The  function  returns  0  if  successful.  It  returns  E_LIMIT  if  there  is  no  room  for  the  new 
tank  or  model. 


Called  By:  msg_staticveh_statc 


547 


BBN  Systems  and  Technologies 


GTIOO  RTSW  CSCI 


Routines  Called:  FIND_LM 

sim_bal_static_add 


Parameters:  MSG_STATICVEH_STATE  *msgp 

DB_E^O  *pdbase 

INT_4  vme_offset 

INT_4  backend 


Returns:  0 

E_LIMIT 


2.13.46  sys_controI.c 

The  functions  in  the  sys_control.c  CSU  interface  with  the  EVC  (Ethernet  VME  Controller) 
board.  The  purpose  of  this  board  is  to  allow  frame  interrupts  onto  the  VME  bus. 

These  functions  are: 

•  sys_control_init 

•  sys_frame_rate 

•  set_leds 

•  sys_slave_sync 

•  sys_master_sync 

•  get_dtp_bank 

•  read_evc_control 

•  write_evc_control 

•  write_evc_frame 

The  typedef  for  the  EVC  structure  is  also  defined  in  this  CSU.  The  EVC  structure  contains 
the  following: 

•  Interrupt  control  register  (icr). 

•  Interrupt  vector  (ivr). 

•  LED  display  value. 

•  System  control  register.  This  is  a  control  word  that  describes  the  EVC  mode,  CIG 
mode  (master  or  slave),  the  current  EVC  bank  (the  double  buffer  in  use  by  the 
hardware  this  frame),  and  the  frame  rate. 

•  Single_shot  system  frame  register,  used  for  «TBD». 


2.13.46.1  sys_controI_init 

The  sys_control_init  function  initializes  frame  interrupts.  This  function  is  called  when  the 
system  is  initialized.  It  is  also  called  through  Gossip  if  the  user  selects  the  i  ("initialize 
EVC")  option  from  the  GT  Hardware  menu,  reached  through  the  Gossip  System  menu. 

The  function  call  is  sys_control_init(prate,  ptime),  where: 
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prate  is  a  pointer  to  the  CIG's  frame  rate;  this  can  be  entered  by  the  user  on  the 

command  line  at  startup;  if  no  speed  is  specified,  the  initialize  function  sets  a  default 
value 

ptime  is  a  pointer  to  the  frame  time;  this  is  calculated  by  sys_frame_rate 
sys_control_init  does  the  following: 

•  Sets  use_evc  to  FALSE. 

•  Calls  sysrup_off  to  disable  system  interrupts. 

•  Calls  bus_error  to  look  for  the  EVC  board;  if  found,  sets  use_evc  to  TRUE. 

•  Sets  the  EVCs  interrupt  vector. 

•  Initializes  the  EVCs  control  register  to  normal  mode. 

•  Calls  sys_master_sync  to  set  the  EVC  to  operate  as  the  master  frame  interrupt. 

•  Calls  sys_frame_rate  to  set  the  EVCs  frame  rate. 

•  Sets  the  EVCs  interrupt  control  register. 

The  function  exits  with  a  1  if  it  cannot  find  the  EVC  board. 


Called  By:  gos_system 

initialize 


Routines  Called:  bus_error 

exit 
printf 

sys_frame_rate 

sys_master_sync 

sysrup_off 


Parameters:  INT_4 

INT_4 


Returns:  none 


2.13.46.2  sys_frame_rate 

The  sys_frame_rate  function  sets  the  desired  frame  rate  (10, 15, 30,  or  60  Hz)  in  the 
EVCs  system  control  register.  The  frame  rate  set  is  bas^  on  the  speed  entered  by  the 
operator  on  the  command  line  (using  the  "s"  argument)  at  startup.  If  no  speed  was 
specified,  the  default  selected  by  the  initialize  function  is  used. 

The  function  call  is  sys_frame_rate(prate,  ptime),  where: 

prate  is  a  pointer  to  the  frame  rate 

ptime  is  a  pointer  to  the  frame  time;  this  is  calculated  by  sys_frame_rate 

If  an  invalid  frame  rate  is  specified  in  the  call,  sys_frame_rate  assigns  a  default  of  30. 
sys_frame_rate  also  calculates  the  frame  time  based  on  the  frame  rate. 


*prate 

*ptime 
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Called  By:  sys_control_init 


Routines  Called;  printf 


Parameters;  INT_4  *prate 

INT_4  *ptime 


Returns:  none 


2.13.46.3  set_leds 

The  set_leds  function  displays  a  value  on  the  EVC’s  LED  display.  This  function  is  called 
at  the  end  of  every  frame  during  a  simulation.  It  is  also  invoked  through  Gossip  if  the  user 
selects  the  1  ("write  into  leds")  option  from  the  GT  Hardware  menu,  reached  through  the 
Gossip  System  menu. 

The  function  call  is  set  leds(value),  where  value  is  the  value  to  be  displayed  on  the 
LED. 

The  EVC  LED  display  can  show  any  of  the  following  values: 

•  Model  count. 

•  Frame  count. 

•  Local  terrain  frame  count. 

•  Overload  indicator  (appears  only  if  a  system  overload  is  detected) 

The  display_lights[]  array  in  global  memory  contains  flags  that  enable/disable  each  of  these 
counters  to  appear  on  the  LED.  The  array  is  checked  at  the  end  of  each  frame  to  see  which 
counts  are  to  be  passed  to  setjeds  to  display.  The  flags  in  display_lights[]  can  be  changed 
using  the  I  ("set  display  lights  flags")  option  on  the  Gossip  System  menu. 


Called  By;  _display_lights 

gos_system 


Routines  Called:  none 


Parameters:  INT_4  value 


Returns:  none 


2.13.46.4  sys_slave_sync 

The  sys_slave_sync  function  synchronizes  the  CIG's  frame  interval  with  an  external  master 
CIG.  This  function  is  called  at  startup  if  the  local  CIG  is  operating  in  a  slave  mode.  Slave 
mode  is  specified  by  entering  the  "S"  argument  on  the  startup  command  line. 
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The  function  call  is  sys_slave_sync(). 


Called  By: 

initialize 

Routines  Called: 

none 

Parameters: 

none 

Returns: 

none 

2.13.46.5  sys_master_sync 

The  sys_master_sync  function  sets  the  local  EVC  to  operate  as  the  master  frame  interrupt. 
This  function  is  c^led  at  startup  if  the  CIG  is  operating  in  master  mode  (the  default). 

The  function  call  is  sys_master_sync(). 


Called  By:  initialize 

sys_control_init 


Routines  Called:  none 


Parameters:  none 


Returns:  none 

2.13.46.6  get_dtp_bank 

The  get_dtp_bank  function  returns  the  number  of  the  double  buffer  currently  being  used  by 
the  Data  Traversal  Processor  (DTP).  The  real-time  software  then  sets  the  current 
simulation  buffer  to  the  opposite  buffer.  (The  real-time  software  and  the  DTP  alternate 
double  buffers  each  frame.  This  provides  the  most  recent  data  to  the  hardware  while  the 
software  updates  the  other  buffer.)  This  function  is  called  at  the  beginning  of  a  new 
simulation,  and  at  the  end  of  every  frame  during  a  simulation. 

The  function  call  is  get_dtp_bank(). 

The  function  obtains  the  bank  number  from  the  EVC's  system  control  register.  It  returns 
EOF  if  the  use_evc  flag  is  false,  indicating  that  the  EVC  board  has  not  been  initialized. 


Called  By:  _reset_model_pointers 

init_simulation 
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Routines  Called:  printf 


Parameters:  none 


Returns:  EOF 

pevc->control_r  &  EVC_BANK 


2.13.46.7  read_evc_controI 

The  read_evc_control  function  returns  the  contents  of  the  EVC's  system  control  register 
(pevc->control_r).  This  function  is  called  through  Gossip  if  the  user  selects  the  d  ("display 
EVC  register")  option  from  the  GT  Hardware  menu,  reached  through  the  Gossip  System 
menu. 

The  function  call  is  read_evc_controI(). 

The  function  returns  the  data  in  the  control  register  as  value.  The  value  is  set  to  EOF  if  the 
use_evc  flag  is  false,  indicating  that  the  EVC  board  is  not  initialized. 


Called  By:  gos_system 

Routines  Called:  printf 

Parameters:  none 


Returns:  value 


2.13.46.8  write_evc_control 

The  write_evc_control  function  writes  a  specified  value  to  the  EVC's  system  control 
register  (pevc->control_w).  This  function  is  called  through  Gossip  if  the  user  selects  the  c 
("write  into  EVC  frame  rate  control  word")  option  from  the  GT  Hardware  menu,  reached 
through  the  Gossip  System  menu. 

The  function  call  is  write  eve  control(value),  where  value  is  the  value  to  be  written. 


Called  By:  gos_system 

Routines  Called:  printf 

Parameters:  INT_4  value 
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Returns:  none 


2.13.46.9  write_evc_frame 

The  write_evc_frame  function  writes  a  specified  value  to  the  EVCs  system  frame  register 
(pevc->single_shot).  This  function  is  called  through  Gossip  if  the  user  selects  the  r  ("write 
into  EV(^  single  shot  word")  from  the  GT  Hardware  menu,  reached  through  the  Gossip 
System  menu. 

The  function  call  is  write  eve  fraine(value),  where  value  is  the  value  to  be  written. 


Called  By: 

gos_system 

Routines  Called: 

printf 

Parameters: 

INT_4 

Returns: 

none 

2.13.47  upstart.c 

The  upstart.c  CSU  contains  the  driver  for  the  real-time  software.  The  functions  in  this 
eSU  are: 

•  upstart 

•  upstart_cleanup 


2.13.47.1  upstart 

The  upstart  function  is  the  driver  for  the  real-time  applications  software.  It  establishes 
communication  with  the  Simulation  Host,  reads  a  message,  then  calls  the  appropriate 
function  based  on  the  system  state  requested  in  the  message. 

The  function  call  is  upstart().  upstart  does  the  following: 

•  Calls  start_watch  to  start  the  system  timer. 

•  Initializes  the  local_terTain_wanted  variable  to  TRUE. 

•  Calls  poll_shutdown  to  see  if  a  system  shutdown  has  been  requested. 

•  Processes  each  message  received  from  the  Simulation  Host: 

-  Increments  the  packet  buffer  size;  checks  for  packet  buffer  overflows. 

-  Calls  cigsimio_msg_in  to  write  the  message  to  a  buffer  (if  message 
recording  or  debug  display  is  enabled). 

-  Processes  the  message  according  to  its  type  (see  table  below). 
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The  following  table  summarizes  the  processing  performed  by  upstart  in  response  to  each 
valid  message  type  it  receives  from  the  Simulation  Host.  The  first  column  lists  the 
messages  in  alphabetical  order.  The  second  column  briefly  describes  the  purpose  of  the 
message  (in  it^cs),  then  lists  the  major  steps  upstart  performs  to  process  the  message. 


Message  from  SIM  Host 

Processing  by  upstart 

MSG_AMMO_DEFINE 

Defines  ammunition  maps. 

Loads  the  specified  ammo.map  tables  into  memory. 

MSG  CIG  CTL 

C_DB_SETUP 

C  FILE  XFER 

C  MCC  SETUP 

C  NULL 

C  STOP 

C_TEST_MODE 

Causes  a  transition  to  another  performance  state. 

Calls  db_mcc_setup  with  state  set  to  C_DB_SETUP. 
Calls  file_control  with  state  set  to  C_FILE_XFER. 

Calls  db_mcc_setup  with  state  set  to  C_MCC_SETUP. 
No  action. 

No  action. 

Calls  hw_test  with  state  set  to  C_TEST_MODE. 

MSG.DRl  1_PKT_SIZE 

Specifies  exchange  packet  parameters. 

Outputs  data  from  message  to  stdout;  sets  CIG  and  SIM 
exchange  packet  sizes;  validates  local  terrain  chunk  size 
and  message  interval,  and  sets  if  valid;  sets  CIG 
hardware  type. 

MSG.END 

Signals  end  of  packet  buffer. 

Calls  cigsimio_msg_out  to  write  outgoing  message 
packet  to  buffer  if  recording  is  enabled;  calls 
start_watch;  calls  appropriate  exchange_data  routine 
(through  *exchange_data)  to  exchange  packets. 

MSG_PPM_DISPLAY_MODE 

Changes  PPM  display  modes. 

Calls  msg_ppm_display_mode. 

MSG_PPM_DISPLAY_OFFSET 

Changes  PPM  display  offsets. 

Calls  msg_ppm_display_offset. 

MSG_PPM_PIXEL_LOCATION 

Sets  a  new  PPM  pixel  location. 

Calls  msg  ppm  pixel  location. 

MSG_PPM_PIXEL_STATE 

Turns  PPM  pixel  processing  on  or  off. 

Calls  msg_ppm_pixel_state. 

Called  By:  none  (task  created  and  started  at  initialization  time) 


Routines  Called:  *exchange_data 

cigsimio_msg_in 
cigsimio_msg_out 
db_mcc_setup 
file_control 
GLOB 
hw_test 

msg_ppm_display_mode 

msg_ppm_display_offset 

msg_ppm_pixel_location 

msg_ppm_pixel_state 

polLshutdown 

printf 
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start_watch 

SYSERR 

Parameters:  none 

Returns:  none 

2.13.47.2  upstart_cleanup 

The  upstart_cleanup  function  deallocates  the  resources  owned  by  the  upstart  task.  This 
function  is  called  when  a  system  shutdown  is  requested  by  the  Gossip  user.  The  function 
is  called  via  the  *task_cleanup  function  pointer,  which  points  to  the  cleanup  routine's  name 
in  the  task  table. 

The  function  call  is  upstart_cleanup(). 

The  function  returns  1  if  successful,  or  0  if  an  error  occurred. 

Note:  This  function  is  not  yet  implemented.  At  the  current  time,  it  simply 
returns  a  1  if  called. 

Called  By:  poll_shutdown  (through  *task_cleanup) 

Routines  Called:  none 

Parameters:  none 

Returns:  0 

1 
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2.14  Serial  Device  Input/Output  (/cig/libsrc/libsio) 

The  Serial  Device  Inpul/Output  CSC  lets  the  Simulation  Host  write  to  a  serial  I/O  device 
during  a  simulation.  Messages  are  used  to  open,  write  to,  and  close  the  device.  This 
feature  can  be  used  to  record  simulation-related  data  to  a  serial  printer,  or  to  drive  a  serial 
device  that  performs  sort  sort  of  processing  during  the  simulation. 

A  maximum  of  four  serial  devices  can  be  open  during  one  simulation.  For  each  device,  the 
Simulation  Host  specifies  the  following: 

•  The  device  name.  This  is  used  to  establish  an  output  channel  to  the  device. 

•  A  unique  identifier  (0-3). 

•  The  maximum  number  of  frames  to  delay  before  actually  sending  data  to  the  device. 
This  delay  allows  synchronization  of  data  written  to  the  device  with  outputs  from 
other  parts  of  the  system. 

•  The  maximum  number  of  characters  to  be  written  to  the  device  during  any  given 
frame. 

Each  write  message  specifies  the  following: 

•  The  data  to  be  sent. 

•  The  identifier  of  the  device  to  which  the  data  is  to  be  written. 

•  The  number  of  frames  to  delay  before  writing  the  data.  This  delay  must  be  less 
than  or  equal  to  the  ma: '  um  delay  specified  for  the  device. 

All  data  to  be  wrinen  to  a  device  is  buffered  in  a  local  queue  until  the  specified  frame  delay 
expires.  The  queue  is  implemented  as  an  array,  with  the  array  size  set  equal  to  the 
maximum  frame  delay  plus  1.  Each  element  in  a  device’s  array  contains  the  data  to  be 
written  to  that  device  during  a  particular  frame. 

For  example,  a  device  with  a  maximum  frame  delay  of  3  has  an  output  queue  array 
containing  four  elements.  When  the  Simulation  Host  sends  a  write  message,  a  Serial 
Device  I/O  function  determines  (based  on  the  message's  frame  delay)  which  element  the 
data  is  to  be  stored  in.  If  it  reaches  the  end  of  the  array,  it  wraps  back  around  to  the  first 
element. 


Currant  Frame 
Pointer 
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At  the  end  of  each  frame,  a  tick  function  accesses  the  current  frame’s  element  in  each 
device’s  array,  and  writes  all  of  the  stored  data  to  that  device.  The  data  in  the  element  may 
come  from  multiple  write  messages.  The  tick  function  then  moves  the  current  frame 
pointer  to  the  next  element,  for  use  during  the  next  frame. 


Current  Frame 
Pointer 


1 


Element  1 

■ 

Element  2 

■ 

Elements 

■ 

Element  4 

Messages  with 
frame  delay>3 

1 

Messages  with 
frame  delayoO 

1 

Messages  with 
frame  delay«1 

1 

Messages  with 
frame  delay..2 

As  shown  in  Figure  2-18,  the  Serial  Device  Input/Output  CSC  consists  of  only  one  CSU, 
sio.c.  This  CSU  is  described  in  this  section. 


Figure  2-18.  Serial  Device  Inpui/Output  CSU 


2.14.1  sio.c 

The  functions  in  the  sio.c  CSU  handle  all  communication  with  the  serial  devices.  These 
functions  are: 

•  sio_init 

•  sio_write 

•  sio_close 

•  sio_tick 


2.14.1.1  sio_init 

The  sio_init  function  opens  a  channel  to  a  serial  device.  This  function  is  called  when  the 
Simulation  Host  sends  a  MSG_SIO_INIT  message  during  the  "prepare  for  simulation" 
state.  The  message  specifies  the  device  name,  an  identifier  to  associate  with  the  device,  the 
maximum  frame  delay,  and  the  maximum  number  of  characters  to  be  written  during  any 
one  frame. 
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The  function  call  is  sio_init(insgp),  where  msgp  is  a  pointer  to  the  MSG_SIO_INIT 
message. 

sio_init  does  the  following: 

•  Verifies  that  the  identifier  is  valid. 

•  Makes  sure  the  specified  identifier  is  not  already  in  use  by  another  open  device. 

•  Opens  the  device  in  write-only  mode. 

•  Allocates  memory  for  an  output  queue  for  the  device;  the  number  of  array  elements 
is  set  equal  to  one  more  than  the  maximum  frame  delay  specified  in  the  messag. 

•  Allocates  memory  for  each  queue  element  (one  per  frame);  the  size  of  each  element 
is  set  equal  to  the  maximum  number  of  characters  per  frame  specified  in  the 
message. 

The  function  returns  0  if  successful.  If  an  enor  occurs,  the  function  returns  err  set  to  one 
of  the  following  values: 

14  (E_SIODEVID)  Invalid  identifier. 

15  (E_SIOIDUSED)  Identifier  already  assigned. 

17  (E_SIOOPEN)  Error  opening  device. 

1 8  (E_SIOMEM)  Insufficient  memory  for  output  queue. 


Called  By:  db_mcc_setup 


Routines  Called:  caUoc 

free 

ifx_open 

malloc 


Parameters:  MSG_SIO_INIT  *msgp 


Returns:  0 

err 


2.14.1.2  sio_write 

The  sio_write  function  places  the  data  sent  by  the  Simulation  Host  for  a  serial  device  into 
the  appropriate  frame  element  of  the  device’s  output  queue.  This  function  is  called  when 
the  Simulation  Host  sends  a  MSG_SIO_WRITE  message.  The  message  specifies  the  data, 
the  data  length  in  bytes,  and  the  frame  delay. 

Data  from  multiple  write  messages  to  the  same  device  to  be  output  during  the  same  frame  is 
concatenated  together. 

The  function  call  is  sio_write(insgp),  where  msgp  is  a  pointer  to  the  MSG_SI0_WR1TE 
message. 

sio_write  does  the  following: 
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•  Makes  sure  the  specified  identifier  is  valid. 

•  Makes  sure  the  specified  identifier  is  in  use  by  an  open  device. 

•  Makes  sure  the  specified  frame  delay  does  not  exce^  the  device's  maximum  frame 
delay. 

•  Makes  sure  there  is  room  in  the  specified  frame  element  for  the  additional  data  (i.e., 
that  the  maximum  length  per  firame  specified  by  the  Simulation  Host  will  not  be 
exceeded). 

•  Copies  the  data  to  the  appropriate  frame  element  in  the  device's  output  queue.  If  the 
message's  fiame  delay  is  1,  for  example,  the  data  is  written  to  the  next  element  after 
the  current  one.  When  the  end  of  the  array  is  reached,  sio_write  wraps  back  around 
to  the  beginning. 

•  Increments  the  character  count  for  the  selected  queue  element  by  the  size  of  the  new 
data. 

The  function  returns  0  if  successful.  If  an  error  occurs,  the  function  returns  err  set  to  one 
of  the  following  values: 

14  (E_SIODEVID)  Invalid  identifier. 

16  (E_SIOIDNO'nJSED)  No  currently  open  device  has  this  identifier. 

20  (E_SIOOVFLO)  Output  queue  overflow. 

21  (E_SIOFRAME)  Invalid  frame  delay. 


Called  By: 
Routines  Called: 
Parameters: 

Returns: 


process_a_msg 

bcopy 

MSG_SIO_WRITE 

0 

err 


*msgp 


2.14.1.3  sio_close 

The  sio_close  function  closes  a  channel  to  a  specified  serial  device,  and  frees  the  memory 
allocated  to  its  output  queue.  This  function  is  called  if  the  Simulation  Host  sends  a 
MSG_SIO_CLOSE  message,  which  is  valid  only  during  the  "prepare  for  simulation"  state. 

The  function  call  is  sio_close(iiisgp),  where  msgp  is  a  pointer  to  the  MSG_S10_CL0SE 
message. 

The  function  does  the  following: 

•  Makes  sure  the  identifier  is  valid. 

•  Makes  sure  the  device  is  currently  open  (i.e.,  that  the  identifier  is  flagged  in-use). 

•  Frees  the  memory  allocated  to  the  device's  output  queue. 

•  Closes  the  channel  to  the  device. 

•  Marks  the  identifier  as  not  in-use. 
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The  function  returns  0  if  successful.  If  an  error  occurs,  the  function  returns  err  set  to  one 
of  the  following  values: 

14  (E_SIODEVID)  Invalid  identifier. 

16  (E_SIOIDNO'IlJSED)  No  currently  open  device  has  this  identifier. 

22  (E_SIC)CLOSE)  Error  closing  device. 


Called  By:  db_mcc_setup 


Routines  Called:  free 

ifx_close 


Parameters:  MSG_SIO_CLOSE  *msgp 


Returns:  0 

err 


2.14.1.4  sio_tick 

The  sio_tick  function  writes  the  queued  data  to  each  open  device.  This  function  is  called  at 
the  end  of  every  frame  while  the  CIG  is  in  the  simulation  state.  All  data  queued  for  a  given 
device  that  has  reached  its  specified  frame  delay  is  written  to  the  device.  Note  that  this  data 
may  be  from  multiple  messages. 

The  function  call  is  sio_tick().  For  each  identifier  that  is  flagged  as  in-use,  sio_tick  does 
the  following: 

•  Determines  whether  the  current  frame  element  in  the  device's  queue  contains  data  to 
write. 

•  Writes  all  data  in  the  current  frame  element  to  the  device. 

•  Resets  the  character  count  in  the  current  frame  element  to  0. 

•  Increments  the  queue  index  (the  pointer  to  the  current  queue  element  in  the  array) 
for  use  the  next  frame. 

The  function  returns  0  if  successful.  If  a  write  error  occurs,  the  function  returns  err  set  to 
19  (E.SIOWRTTE). 


CaUed  By: 

msg_end 

Routines  Called: 

ifx_write 

Parameters: 

none 

Returns: 

0 

err 
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2.15  Token  Processing  (/cig/Iibsrc/libtoken) 

The  Token  Processing  CSC  functions  are  used  to  parse  and  process  the  data  in  the 
subsystem  configuration  (subsys.cfg)  file.  This  file,  which  is  read  at  initialization  time, 
identifies  the  data  files  to  be  used  for  the  simulation  exercise. 

The  default  subsystem  configuration  file  is  subsys.cfg.  The  Simulation  Host  can  load  a 
different  configuration  file  by  sending  a  MSG_nLE_DESCR  message  with  db  req  set  to 
DB_SUBSYS_0  or  DB_SUBSYS_1.  (The  0  or  1  identifies  the  backend.)  Similarly,  the 
Simulation  Host  can  load  an  individual  database  file  by  sending  a  MSG_FILE_DESCR 
message  with  db  req  set  to  the  appropriate  file  type. 

Each  subsystem  (backend)  has  its  own  set  of  database  files.  An  array  indexed  by 
subsystem  id  is  maintained  for  each  file  name.  Separate  functions  are  provided  to  set  or 
return  each  file  name. 

The  files  identified  in  subsys.cfg,  and  the  MSG_FILE_DESCR  messages  that  can  be  used 
to  specify  them,  are  the  following: 


File  Name  Array 

File  Contents 

MSG_FILE_DESCR 
db_req  setting 

daiabase_nameD 

Tenain  database 

DB  SETUP  0 
DB_SETUP_1 

ded_nameQ 

Dynamic  Elements  Database 
(DED) 

DB  DED  SETUP  0 
DB_DED_SETUP_I 

final_lut_name[] 

Final  (2-D)  lookup  table 

DB  FINAL  LUT  0 
DB_FINAL_LUT_1 

3djut_name0 

3-D  lookup  table 

DB  3D  LUT  0 
DB_3D_LUT_1 

data_2d_nameQ 

2-D  overlay  configuration  data 

DB  2D  DATA  0 
DB_2D_DATA_1 

csifa_name[] 

ESIFA  textures 

DB  ESIFA  LOAD  0 
DB_ESIFA_LOAD_l 

color_config_nameQ 

Color  configuration  data 

DB  COLOR  CFG  0 
DB_COLOR_CFG_l 

Figure  2-19  identifies  the  CSUs  in  the  Token  Processing  CSC. 
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Figure  2-19.  Token  Processing  CSUs 


2.15.1  lex.c 


The  functions  in  the  lex.c  CSU  are  lexical  utilities  used  to  parse  the  subsystem 
configuration  file.  These  functions  are: 


•  set_token_fiIe 

•  next_char 

•  scan_number 

•  next_token 

•  next_line 

•  swallow_token 

•  get_next_token 

•  get_current_token 

•  get_number_value 

•  get_string_value 


The  subsystem  configuration  file  is  composed  of  tokens  followed  by  numeric  or  string 
values.  All  recogniz^  tokens  are  defin^  in  the  lex.h  and  keywords.h  include  files. 


2.15.1.1  set_token_file 

The  set_token_file  function  gets  the  name  of  the  subsystem  configuration  file  and  sets  it  for 
the  other  Token  Processing  functions  to  use.  It  also  initializes  the  work  buffer  and  sets  the 
buffer  size.  This  function  is  called  at  start-up  if  a  subsys.cfg  file  is  found.  It  is  also  called 
if  the  Simulation  Host  sends  a  MSG_FILE_DESCR  message  with  db  req  set  to 
DB_SUBSYS_0  or  DB_SUBSYS_1. 

The  function  call  is  set_token_file(rile_ptr),  where  file _ptr  is  a  pointer  to  the 
subsystem  configuration  file. 


Called  By:  db_mcc_setup 

initialize 
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Routines  Called: 

none 

Parameters: 

HLE 

*file_ptr 

Returns: 

none 

2.15.1.2  next_char 

The  next_char  function  fetches  the  next  character  from  the  file  and  sets  a  pointer 
(input_char)  to  it.  If  the  buffer  is  empty,  next_char  reads  in  a  new  buffer  of  data. 

The  function  call  is  next_char(). 

If  next_char  finds  the  end  of  the  file,  it  sets  the  input  character  to  -1  and  sets  the  end-of-file 
flag  (at_eof)  to  TRUE. 


Called  By: 

next_token 

scan_number 

Routines  Called: 

fread 

Parameters: 

none 

Returns: 

none 

2.15.1.3  scan_number 

The  scan_number  function  scans  over  a  number  and  converts  it  to  binary.  This  function  is 
called  whenever  the  input  character  is  a  digit  from  0  through  9. 

The  function  call  is  scan_number().  The  function  converts  the  digit,  then  calls  next_char 
to  get  the  next  digit.  It  continues  to  convert  each  digit  until  it  receives  a  character  outside 
the  range  0  through  9. 


Called  By: 

next_token 

Routines  Called: 

next_char 

Parameters: 

none 

Returns: 

none 
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2.15.1.4  next_token 

The  next_token  function  examines  the  current  input  character  (or  a  string  of  consecutive 
characters)  and  sets  the  variable  token  accordingly. 

The  function  call  is  next_token().  The  function  does  the  following: 

•  Checks  to  see  if  the  input  character  is  a  space;  calls  next_char  to  get  another 
character  if  it  is. 

•  Examines  the  input  character. 

•  If  the  input  character  is  not  a  letter,  sets  token  to  the  appropriate  recognized  token. 

-  In  some  cases,  calls  next_char  to  determine  to  correct  token  (e.g.,  checks 
for  "="  after  ">",  and  checks  for  a  number  after  a  minus  sign). 

-  If  the  character  is  between  0  and  9,  calls  scan_number  to  convert  it  to 
binary. 

-  If  the  character  is  -1  (next_char’s  signal  for  end-of-file),  sets  token  to 
tokenEOF. 

•  If  the  input  character  is  a  letter 

-  Puts  the  letter  into  an  array. 

•  Calls  next_char  to  get  the  next  character  and  adds  it  to  the  array. 

•  Compares  the  array  with  the  list  of  valid  words. 

•  Keeps  adding  letters  up  to  the  maximum  length  allowed,  looking  for  a 
match. 

•  If  a  match  is  found,  sets  token  to  the  matching  word. 

•  If  no  match  is  found,  sets  token  to  tokenString. 


Called  By: 

get_next_token 

next_line 

parse_subsys_file 

swallow_token 

Routines  Called: 

next_char 

scan_number 

strcmp 

Parameters: 

none 

Returns: 

none 

1.5  next_line 

The  next_line  function  skips  to  the  first  token  on  the  next  line  of  the  file.  It  calls 
next_token  until  it  finds  a  tokenEOL  token,  then  calls  next_token  once  more  so  token  is  set 
to  the  first  token  on  the  following  line. 

The  function  call  is  next  line(). 
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Called  By: 

none 

Routines  Called: 

next_token 

Parameters: 

none 

Returns: 

none 

2.15.1.6  swanow_token 

The  swallow_token  function  checks  that  a  particular  token  is  present,  then  skips  it  by 
calling  next_token.  This  function  is  used  to  verify  that  the  correct  starting  and  ending 
tokens  are  present  in  the  file. 

The  function  call  is  swallow  token(tok),  where  tok  is  the  token  expected  next  in  the 
file. 

swallow_token  returns  0  if  the  specified  token  was  found.  If  a  different  token  was  found, 
the  function  outputs  an  error  and  returns  1. 


Called  By:  parse_subsys_file 


Routines  Called:  get_string_value 

next_token 

printf 


Parameters;  int  tok 


Returns:  0 

1 


2.15.1.7  get_next_token 

The  get_next_token  function  calls  next_token  to  read  the  next  token  from  the  file.  It  then 
returns  the  new  value  of  token. 

The  function  call  is  get_next_token(). 

Called  By:  parse_subsys_filc 

Routines  Called:  next_token 
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Parameters: 

none 

Returns: 

token 

2.15.1.8  get_current_token 

The  get_currcnt_token  function  returns  the  current  value  of  token. 
The  function  call  is  get_current_token(). 


Called  By: 


parse_subsys_file 


Routines  Called: 


none 


Parameters: 

Returns: 


none 


token 


2.15.1.9  get_number_value 

The  get_number_value  function  returns  the  current  value  of  token_num_value.  This  value 
is  set  by  scan_number  and  next_token.  This  function  is  used  to  get  the  subsystem 
(backend)  id  specified  in  the  configuration  file. 

The  function  call  is  get_number_value(). 


Called  By: 
Routines  Called: 

Parameters: 

Returns: 


parse_subsys_file 

none 

none 

token_num_value 


2.15.1.10  get_string_value 

The  get_string_value  function  returns  the  current  value  of  token  string  value.  This  value 
is  set  by  next  _token  when  parsing  the  command  lines  in  the  subsystem  configuration  file. 
This  function  is  used  to  determine  which  file  name  is  being  set,  as  well  as  to  get  the  file 
name. 
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The  function  call  is  get_string_value(). 


Called  By: 

Routines  Called: 

Parameters: 

Returns: 


parse_subsys_file 

swallow_token 

none 

none 

token_string_value 


2.15.2  subsys_cfg_parse.c 

The  functions  in  the  subsys_cfg_parse.c  CSU  are  used  to  read  the  information  in  the 
subsys.cfg  configuration  file.  Routines  are  provided  to  get  and  set  each  file  name. 

The  functions  in  this  CSU  are: 


•  init_subsys_parser 

•  parse_subsys_file 

•  get_database_name 

•  get_ded_name 

•  get_final_lut_name 

•  get_3d_lut_name 

•  get_data_2d_name 

•  get_esifa_name 

•  get_color_config_name 

•  set_database_name 

•  set_ded_name 

•  set_final_lut_name 

•  set_3d_lut_name 

•  set_data_2d_name 

•  set_esifa_name 

•  set_color_config_name 


2.15.2.1  init_subsys_parser 

The  init_subsys_parser  function  initializes  the  names  of  all  database  configuration  files  for 
all  backends  to  blanks.  This  function  is  called  at  startup,  before  the  subsys.cfg  file  is 
opened  and  processed.  It  is  also  called  if  the  Simulation  Host  sends  a 
MSG_FILE_DESCR  message  with  db  req  set  to  DB_SUBSYS_0  or  DB_SUBSYS_1 
(before  opening  and  processing  the  file  specified  in  the  message). 

The  function  call  is  inU_subsys_parser(). 


Called  By:  db_mcc_setup 

initialize 
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Routines  Called:  strcpy 


Parameters:  none 


Returns:  none 


2.15.2.2  parse_subsys_file 

The  parse_subsys_file  function  reads  the  subsystem  configuration  file  and  sets  the  database 
file  name  variables  with  the  file  names  specific  in  the  file.  This  function  is  called  at 
system  initialization  time  to  read  and  process  the  subsys.cfg  file  It  is  also  called  if  the 
Simulation  Host  sends  a  MSG_FILE_DESCR  message  with  db  req  set  to 
DB_SUBSYS_0  or  DB_SUBSYS_1. 

The  function  call  is  parse_subsys_file().  The  function  does  the  following: 

•  Verifies  that  the  file  begins  with  the  token_start  and  token_subsystem  tokens. 

•  Calls  get_number_value  to  determine  the  subsystem  (backend)  id. 

•  Validates  the  subsystem  id. 

•  Calls  next_token  to  read  each  token  in  the  file. 

-  Makes  sure  the  token  is  followed  by  a  file  name. 

-  Copies  the  file  name  to  the  subsystem's  element  in  the  appropriate  file  name 
array. 

•  Stops  processing  when  the  token_end  token  is  found. 

The  function  returns  ERROR  if  the  file  format  is  invalid,  an  unknown  token  is  found,  a 
token  is  not  followed  by  a  file  name,  or  the  subsystem  id  is  invalid. 


Called  By:  db_mcc_setup 

initialize 


Routines  Called:  get_current_token 

get_next_token 

get_number_value 

get_string_value 

next_token 

printf 

strcpy 

swadlow_token 


Parameters:  none 


Returns: 


1  (ERROR) 
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2.15.2.3  get_database_name 

The  get_database_name  function  reuims  the  name  of  the  terrain  database  file  for  a  specified 
subsystem.  Terrain  database  file  names  are  stored  in  the  database_name[]  array,  indexed 
by  subsystem  id. 

The  function  call  is  get_database_name(subsys),  where  subsys  is  the  backend  id. 


Called  By: 


config_database 

db_mcc_setup 

initialize 


Routines  Called: 

Parameters: 

Returns: 


none 

int 

database_name[subsys] 


subsys 


2.15.2.4  get_ded_name 

The  get_ded_name  function  returns  the  name  of  the  Dynamic  Elements  Database  file  for  a 
specified  subsystem.  DED  file  names  are  stored  in  the  ded_name[]  array,  indexed  by 
subsystem  id. 

The  function  call  is  get_ded_name(subsys),  where  subsys  is  the  backend  id. 


Called  By: 

Routines  Called: 

Parameters: 

Returns: 


config_database 

db_mcc_setup 

initialize 

none 

int 

ded_name[subsys] 


subsys 


2.15.2.5  get_finaMut_name 

The  get_final_lut_name  function  returns  the  name  of  the  final  (2-D)  lookup  table  file  for  a 
specified  subsystem.  Final  lookup  table  names  are  stored  in  the  final_lut_name[]  array, 
indexed  by  subsystem  id. 
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The  function  call  is  get_final_lut_naine(subsys),  where  subsys  is  the  backend  id. 

Called  By;  db_mcc_setup 

initialize 

Routines  Called;  none 

Parameters;  int  subsys 

Returns;  final_lut_name[subsys] 

2.15.2.6  get_3d_lut_name 

The  get_3d_lut_name  function  returns  the  name  of  the  3-D  color  lookup  table  file  for  a 
specified  subsystem.  3-D  lookup  table  file  names  are  stored  in  the  lut_3d_name[]  array, 
indexed  by  subsystem  id. 

The  function  call  is  get_3d_Iut_name(subsys),  where  subsys  is  the  backend  id. 

Called  By;  db_mcc_setup 

initialize 

Routines  Called;  none 

Parameters;  int  subsys 

Returns;  lut_3d_name[subsys] 

2.15.2.7  get_data_2d_name 

The  get_data_2d_name  function  returns  the  name  of  the  2-D  overlay  data  file  for  a  specified 
subsystem.  2-D  overlay  database  file  names  are  stored  in  the  data_2d_name[]  array, 
indexed  by  subsystem  id. 

The  function  call  is  get_data_2d_name(subsys),  where  subsys  is  the  backend  id. 

Called  By;  db_mcc_setup 

initialize 

Routines  Called;  none 
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Parameters;  int  subsys 

Returns:  data_2d_name[subsys] 

2.15.2.8  get_esifa_name 

The  get_esifa_name  function  returns  the  name  of  the  ESIFA  textures  file  for  a  specified 
subsystem.  Textures  file  names  are  stored  in  the  esifa_name[]  array,  indexed  by 
subsystem  id. 

The  function  call  is  get_esifa_name(subsys),  where  subsys  is  the  backend  id. 

Called  By:  db_mcc_setup 

initialize 

Routines  Called:  none 

Parameters:  int  subsys 

Returns:  esifa_name[subsys] 

2.15.2.9  get_coIor_config_name 

The  get_color_config_name  function  returns  the  name  of  the  color  configuration  file  for  a 
specified  subsystem.  Color  configuration  file  names  are  stored  in  the  color_config_name[] 
array,  indexed  by  subsystem  id. 

The  function  call  is  get_color_config_name(subsys),  where  subsys  is  the  backend  id. 

Called  By:  db_mcc_setup 

initialize 

Routines  Called:  none 

Parameters:  int  subsys 

Returns:  color_config_name[subsys] 

2.15.2.10  'set_database_name 

The  set_database_name  function  sets  the  name  of  the  terrain  database  file  for  a  specified 
subsystem  in  the  database_name[]  array.  This  function  is  called  when  the  Simulation  Host 
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sends  a  MSG_FILE_DESCR  message  with  db  req  set  to  DB_SETUP_0  or 
DB_SETUP_1. 

The  function  call  is  set_database_name(subsys,  name),  where: 

subsys  is  the  backend  id 

name  is  the  name  of  the  file  to  be  used 


Called  By: 
Routines  Called: 
Parameters: 

Returns: 


db_mcc_setup 

strcpy 

int 

char 

none 


subsys 

♦name 


2.15.2.11  set_ded_name 

The  set_ded_name  function  sets  the  name  of  the  Dynamic  Elements  Database  file  for  a 
specified  subsystem  in  the  ded_namen  array.  This  function  is  called  when  the  Simulation 
Host  sends  a  MSG_FILE_DESCR  message  with  db  req  set  to  DB_DED_SETUP_0  or 
DB_DED_SETUP_1. 

The  function  call  is  set_ded__name(subsys»  name),  where: 

subsys  is  the  backend  id 

name  is  the  name  of  the  file  to  be  used 


Called  By:  db_mcc_setup 

Routines  Called:  strcpy 

subsys 
♦name 

Returns:  none 


Parameters:  mt 

char 


2.15.2.12  set_finaljut_name 

The  set_final_lut_name  function  sets  the  name  of  the  final  (2-D)  lookup  table  file  for  a 
specified  subsystem  in  the  final_lut_name[]  array.  This  function  is  called  when  the 
Simulation  Host  sends  a  MSG_FILE_DESCR  message  with  dbjreq  set  to 
DB_nNAL_LUT_0  or  DB_nNAL_LUT_l . 
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The  function  call  is  set_final_lut_name(subsys,  name),  where: 

subsys  is  the  backend  id 

name  is  the  name  of  the  file  to  be  used 


Called  By: 
Routines  Called; 
Parameters: 

Returns: 


db_mcc_setup 

strcpy 

int 

char 

none 


subsys 

♦name 


2.15.2.13  set_3d_lut_name 

The  set_3d_lut_name  function  sets  the  name  of  the  3-D  lookup  table  file  for  a  specified 
subsystem  in  the  lut_3d_namen  array.  This  function  is  called  when  the  Simulation  Host 
sends  a  MSG_FILE_DESCR  message  with  db_req  set  to  DB_3D_LUT_0  or 
DB_3D_LUT_1. 

The  function  call  is  set_3d_lut_name(subsys,  name),  where: 

subsys  is  the  backend  id 

name  is  the  name  of  the  file  to  be  used 


Called  By: 
Routines  Called: 
Parameters: 

Returns: 


db_mcc_setup 

strcpy 

int 

char 

none 


subsys 

♦name 


2.15.2.14  set_data_2d_name 

The  set_data_2d_name  function  sets  the  name  of  the  2-D  overlay  data  file  for  a  specified 
subsystem  in  the  data_2d_name[]  array.  This  function  is  called  when  the  Simulation  Host 
sends  a  MSG_FILE_DESCR  message  with  db  req  set  to  DB_2D_DATA_0  or 
DB_2D_DATA_1. 

The  function  call  is  set_data_2d_name(subsys,  name),  where: 
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subsys  is  the  backend  id 

name  is  the  name  of  the  file  to  be  used 


Called  By:  db_mcc_setup 

Routines  Called:  strcpy 

subsys 
♦name 

Returns:  none 


Parameters:  int 

char 


2.15.2.15  set_esifa_naine 

The  set_esifa_name  function  sets  the  name  of  the  ESIFA  textures  file  for  a  specified 
subsystem  in  the  esifa_name[]  array.  This  function  is  called  when  the  Simulation  Host 
sends  a  MSG_FILE_DESCR  message  with  db_req  set  to  DB_ESIFA_LOAD_0  or 
DB_ESIFA_LOAD_l. 

The  function  call  is  set_esifa_name(subsys,  name),  where: 

subsys  is  the  backend  id 

name  is  the  name  of  the  file  to  be  used 


Called  By: 
Routines  Called: 

Parameters: 

Returns: 


db_mcc_setup 

strcpy 

int 

char 

none 


subsys 

♦name 


2.15.2.16  set_color_config_name 

The  set_color_config_name  function  sets  the  name  of  the  color  configuration  file  for  a 
specified  subsystem  in  the  color_config_name[]  array.  This  function  is  called  when  the 
Simulation  Host  sends  a  MSG_FILE_DESCR  message  with  dbj  eq  set  to 
DB_COLOR_CFG_0  or  DB_COLOR_CFG_l. 

The  r  ion  call  is  set_color_config_name(subsys,  name),  where: 
subsys  is  the  backend  id 
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name  is  the  name  of  the  file  to  be  used 
Called  By:  db_mcc_setup 

Routines  Called:  strcpy 

Parameters:  int  subsys 

char  *name 

Returns:  none 
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2.16  System  Utilities  (/cig/libsrc/libutil) 

The  System  Utilities  CSC  contains  a  set  of  utility  functions  used  throughout  the  real-time 
software.  These  utilities  provide  the  ability  to  do  the  following: 

•  Block-copy  data. 

•  Open,  re^,  and  close  file  directories. 

•  Find  fields  in  a  file  header. 

•  Find  the  latest  version  of  a  file  with  a  given  name. 

•  Convert  S-format  files  into  executable  code. 

•  Perform  VTIOO  graphics  control. 

Figure  2-20  identifies  the  CSUs  in  the  System  Utilities  CSC. 


bicopy.c 

directory.c 

find_field.c 

find_jgtfn.c 

sload.c 

stdopen.c 

vtlOO.c 


Figure  2-20.  System  Utilities  CSUs 


2.16.1  bicopy.c 

The  blcopy  function  block-copies  a  specified  number  of  bytes  from  one  memory  location  to 
another.  For  example,  this  function  is  used  to  copy  data  from  AAMl  to  AAM2. 

The  function  call  is  bIcopy(from,  to,  count),  where: 

from  is  a  pointer  to  the  source  location 
to  is  a  pointer  to  the  destination  location 
count  is  the  number  of  bytes  to  be  copied 


Called  By:  _copy_reconfigurable_viewports_section 
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_move_load_module_stp_to_quad_buffer 

_update_second_active_area_memory 

active_area_init 

init_siniulation 


Routines  Called: 

none 

Parameters: 

int 

♦from 

int 

♦to 

int 

count 

Returns: 

none 

2.16.2  directory.c 

The  functions  in  the  directory.c  CSU  are  used  to  open,  read,  and  close  file  directories. 
These  functions  are: 

•  OpenDir 

•  ReadDir 

•  CloseDir 

•  GetFileName 


2.16.2.1  OpenDir 

The  OpenDir  function  opens  a  directory  in  read-only  mode. 

The  function  call  is  OpenDir(dirnaine),  where  dirname  is  the  name  of  the  directory  to  be 
opened. 

If  successful,  OpenDir  returns  the  directory  description  as  desc.  If  the  directory  could  not 
be  opened,  OpenDir  outputs  an  error  and  returns  ERROR. 


CaUedBy: 

find_fn 

Routines  Called: 

ifx_open 

printf 

Parameters: 

char 

Returns: 

desc 

-1  (ERROR) 

♦dirname 
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2.16.2.2  ReadDir 

The  ReadDir  function  reads  a  specified  entry  from  a  specified  directory. 

The  function  call  is  ReadDir(desc,  pde),  where: 

desc  is  the  directory  description  returned  from  OpenDir 
pde  is  a  pointer  to  Ae  entry  to  be  read 

The  function  returns  RET_OK  if  successful.  It  outputs  an  error  and  returns  a  1  if  Ae 
specified  entry  could  not  be  read  or  has  never  been  used. 


Called  By: 
Routines  Called: 

Parameters: 

Returns; 


find_fn 


ifx_read 

printf 


mt 

IFXDIRENTRY 


0  (RET.OK) 
1 


desc 

*pde 


2.16.2.3  CloseDir 

The  CloseDir  function  closes  an  open  directory. 

The  function  call  is  CloseDir(desc),  where  desc  is  the  description  returned  by  OpenDir 
for  the  directory. 


Called  By: 

find_fn 

Routines  Called: 

ifx_close 

Parameters: 

mt 

Returns: 

none 

2.16.2.4  GetFileName 

The  GetFileName  function  extracts  a  file  name  from  a  Arectory  entry. 
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The  fu  -ction  call  is  GetFileNaine(pde,  pfn),  where: 

pde  is  a  pointer  to  the  directory  entry 
pfn  is  a  pointer  to  the  file  name 

GetFileName  puts  the  file  name  (including  the  extension,  if  any)  in  the  location  referenced 
by  pfn. 


Called  By:  find_fn 


Routines  Called:  none 


♦pde 

♦pfn 


Returns:  none 


Parameters:  IFXDIRENTRY 

char 


2.16.3  findjield.c  (FindField) 

The  FindField  function  locates  a  specified  header  descriptor  and  returns  its  associated  data 
field.  This  function  is  used  by  mpvideojoad  to  get  information  such  as  the  file  type  and 
file  length  from  the  GSP  header. 

The  function  call  is  FindField(ss,  buf).  where: 

ss  is  the  field  name  to  be  found 

hi/ is  the  header  descriptor  to  be  searched 

FindField  uses  search  to  find  the  specified  field,  then  parses  it  to  find  the  data.  It  returns 
the  data  as  ps.  ps  is  set  to  NULL  if  the  field  cannot  be  found. 


Called  By: 

mpvideojoad 

Routines  Called: 

search 

Parameters: 

char 

char 

Returns: 

ps 

♦ss 

♦buf 
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2.16.4  find_gtfn.c  (find_fn) 

The  find_fh  function  finds  the  file  that  has  the  highest  extension  and  whose  name  matehes  a 
given  character  string.  This  ensures  that  the  calling  procedure  loads  the  latest  version  of  a 
file. 

The  function  call  is  find_fn(conipare,  size,  exact,  filename),  where: 

compare  is  the  name  to  be  matched 

size  is  the  number  of  characters  in  the  compare  string 

exact  specifies  whether  or  not  the  file  name  must  match  the  compare  string  exactly 
filename  is  a  pointer  to  the  file  name  found  by  find_fn 

find_fn  does  the  following: 

•  If  an  exact  match  is  specified: 

-  Converts  the  compare  string  to  uppercase. 

-  Tries  to  open  a  file  with  that  name. 

-  If  a  match  is  found,  puts  the  name  in  filename,  outputs  a  message,  and 
closes  the  file. 

-  If  no  match  is  found,  outputs  a  message  and  continues  to  search  as  if  an 
exact  match  had  not  been  specified. 

•  If  an  exact  match  is  not  specified,  or  an  exact  match  cannot  be  found; 

-  Converts  the  compare  string  to  uppercase. 

-  Finds  the  directoiy  name  in  the  compare  string. 

-  Calls  OpenDir  to  open  the  directory. 

-  Allocates  memory  for  a  directory  entry  block  to  work  in. 

-  Calls  ReadDir  to  read  each  directory  entry,  looking  for  matching  file  names. 

-  If  a  match  is  found,  checks  to  see  if  the  extension  is  greater  than  any 
previous  match  found. 

-  If  the  extension  is  greater  than  any  previous  match,  extracts  the  file  name 
(by  calling  GetFileName)  and  saves  it. 

-  When  all  directory  entries  have  been  read,  calls  CloseDir  to  close  the 
directory. 

-  Frees  the  directory  entry  memory  block. 

-  If  a  match  was  found,  puts  the  name  in  filename  and  outputs  a  message. 

The  function  returns  TRUE  if  a  match  is  found,  or  FALSE  if  no  match  is  found.  It  returns 
ERROR  if  the  directory  could  not  be  opened  or  the  working  directory  could  not  be 
allocated. 


Called  By:  flea_init_cig_sw 

gos_120tx 

initialize 

open_dbase 

open_ded 


Routines  Called:  calloc 

close 
CloseDir 
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free 

GetFileName 

open 

C^nDir 

printf 

ReadDir 

strcat 

strcmp 

strcpy 

strlen 

stmcmp 

stmcpy 

toupper 


Parameters:  char  *compare 

int  size 

BOOLEAN  exact 

char  *filename 


Returns:  1  (TRUE) 

0  (FALSE) 
-1  (ERROR) 


2.16.5  sload.c 


The  functions  in  the  sloadx  CSU  are  used  to  convert  a  Motorola  S-format  file  into 
executable  code.  These  functions  are: 


•  sload 

•  get_record 

•  send_data 

•  check_sum 

•  get_binary_data 

•  get_char 

•  ctoi 


2.16.5.1  sload 

The  sload  function  converts  a  Motorola  S-format  file  into  executable  code.  It  reads  data 
from  the  disk  in  sector-sized  chunks,  breaks  the  ASCII  down  into  record-sized  lines,  then 
stores  the  binary  data.  This  function  is  used  to  load  the  forcetask  file. 

The  function  call  is  sload(filename,  offset,  wsize),  where: 

filename  is  the  file  to  be  converted 

offset  is  the  amount  to  add  to  the  binary  data  address 

wsize  is  the  size  of  the  destination  granularity:  c  (character)  or  w  (word) 

sload  does  the  following: 
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•  Validates  the  value  specified  for  wsize. 

•  Calls  open  to  open  the  specified  file. 

•  Calls  get_reconi  to  get  each  record  from  the  file. 

•  Call  check_sum  to  perform  a  checksum  on  each  record. 

•  If  the  record  is  S7,  S8,  or  S9,  closes  the  file  and  returns  OK. 

•  If  the  record  is  SO  or  S5,  ignores  it. 

•  If  the  recOTd  is  S 1,  S2,  or  S3,  calls  get_binary_address  and  send_data  to  collect  the 
addresses. 

The  function  returns  OK  if  successful.  It  returns  ERROR  if  the  write  size  is  invalid,  the 
file  could  not  be  opened,  a  record  has  a  bad  checksum,  or  an  early  end-of-file  is  detected. 


Called  By; 

bootforce 

Routines  Called: 

check_sum 

close 

get_binary_data 

get_char 

get_record 

open 

printf 

send_data 

Parameters: 

char 

♦filename 

INT_4 

offset 

char 

wsize 

Returns: 

0(OK) 

-1  (ERROR) 

2.16.5.2  get_record 

The  get_record  function  fills  a  string  buffer  with  exactly  one  Motorola  S-format  record. 

The  function  call  is  get_record(record),  where  record  is  the  record  to  be  read. 
get_record  does  the  following: 

•  Calls  get_char  to  get  the  first  character  from  the  record. 

-  If  the  character  is  'S'  (the  leading  character),  ignores  it 

-  If  the  character  is  'EOF  (end-of-file),  returns  a  0  and  stops. 

-  If  the  character  is  anything  else,  stores  it. 

•  Calls  get_char  to  read  the  next  three  characters  (the  record  type  and  byte  count). 

•  Calls  get_binaty_data  to  get  the  byte  count. 

•  C!alls  get_char  to  read  the  remaining  bytes  (based  on  the  byte  count). 

The  function  returns  the  S-format  byte  count  if  successful.  It  returns  0  if  there  are  no 
records  in  the  file. 
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Called  By:  sload 


Routines  Called:  get_binaiy_data 

get_char 

printf 


Parameters:  BY'Ili  record[] 

Returns:  0 

byte_count 


2.16.5.3  send_data 

The  send_data  function  writes  ASCII  record  data  to  memory  in  ascending  bytes  from  a 
given  start  address. 

The  function  call  is  send_data(address,  cptr,  count,  wsize),  where: 

address  is  the  initial  load  address  (absolute  S-format) 
cptr  is  a  pointer  to  the  ASCII  record  characters 
count  is  fire  number  of  charaaers  to  transmit 

wsize  is  the  size  of  the  destination  granularity:  c  (character)  or  w  (word) 


Called  By: 

sload 

Routines  Called: 

get_binary_data 

Parameters: 

WORD 

address 

char 

♦cptr 

INT_4 

count 

char 

wsize 

Returns: 

none 

2.16.5.4  check_suni 

The  check_sum  function  verifies  the  checksum  byte  of  an  S-format  record. 

The  function  call  is  check_suni(pointer,  count),  where: 

pointer  points  to  the  record  to  be  checksummed 
count  is  the  byte  count 

The  answer  returned  by  the  function  is  0  if  the  checksum  byte  is  correct.  A  non-zero  value 
indicates  a  bad  checksum. 
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Called  By: 
Routines  Called: 

Parameters: 

Returns: 


sload 

get_bmary_data 

char 

INT_4 

answer 


♦pointer 

count 


2.16.5.5  get_binary_data 

The  get_binary_data  function  receives  a  pointer  to  a  character  string  and  returns  the  binary 
equivalent  of  the  first  specified  number  of  characters. 

The  function  call  is  get_binary_data(cptr,  count),  where: 

cptr  is  a  pointer  to  the  character  string 

count  is  the  number  of  characters  (starting  from  the  beginning  of  the  string)  to  be 
converted 

The  result  is  returned  as  binary _data. 


Called  By: 

check_sum 

get_record 

send_data 

sload 

Routines  Called: 

ctoi 

Parameters: 

char 

♦cptr 

INT_4 

count 

Returns: 

binary_data 

2.16.5.6  get_char 

The  get_char  function  returns  the  next  available  ASCII  character  from  a  sector-sized  buffer. 
If  the  buffer  is  empty,  get_char  reads  the  next  sector  from  disk.  If  there  is  no  next  sector, 
get_char  returns  EOF. 

The  function  call  is  get_char(). 
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CJalledBy: 

get_record 

Routines  Called: 

read 

Parameters: 

• 

none 

Returns: 

*bptr-»-+ 

EOF 

2.16.5.7  ctoi 

The  ctoi  function  converts  a  character  to  an  integer,  and  returns  the  integer. 

The  function  call  is  ctoi(c),  where  c  is  the  character  to  be  converted. 

Called  By:  get_binary_data 

Routines  Called:  none 

Parameters:  char  c 

Returns:  c  -  'O' 

c  -  'A'  +  10 

2.16.6  stdopen.c 

The  stdopen  function  opens  the  console  as  stdin  (in  read-only  mode),  stdout  (in  write-only 
mode),  and  stderr  (in  write-only  mode). 

The  function  call  is  stdopen(). 

This  function  is  not  currently  used. 


Called  By: 

none 

Routines  dialled: 

ifx_open 

Parameters: 

none 

Returns: 

none 
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2.16.7  vtlOO.c 

The  functions  in  the  vtlOO.c  CSU  provide  VTIOO  graphics  control.  These  function  are 
used  primarily  by  the  Flea  and  Gossip  menu  handlers.  The  functions  are: 

•  cup 

•  sgr 

•  double_top 

•  double_bot 

•  double_off 

•  blank 

•  save_cur 

•  restore_cur 

•  scrolLreg 


2.16.7.1  cup 

The  cup  function  positions  the  cursor  at  a  specified  row  and  column. 

The  function  call  is  cup(r,  c),  where: 

r  is  the  row 
c  is  the  column 


Called  By:  derror 

flea_agpt_locations 

flea_agpt_locations_main_menu 

flea_agpt_switches 

flea_agpt_switches_main_menu 

flea_atp 

flea_a^_main_menu 

flea_bd_opts 

fIea_bal_opts_main_menu 

flea_draw_2d 

flea_graphics_test 

flea_graphics_test_main_menu 

flea_prompt 

flea_switches 

flea_switches_main_menu 

flea_veh_control 

flea_veh_control_main_menu 

gos_db_query 

gos_db_query_menu 

gos_main_menu 

gos_ppm_query 

gos_ppm_query_menu 

gos_prompt 

gossip_tick 

host_if_debug_main_menu 

host_if_debug_menu 
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host_if_disable_debug_msgs 

host_if_display_enabled_msgs 

host_if_enable_debug_msgs 

host_list_msgs 

menu_header 

modeLdemo 

tick 

tick_main_menu 

tick_ppin 

tick_ppm_menu 

tick_ppm_n3enu_header 

tickj)pm_update_info 

tick_script 

tick_script_inain_nienu 

update_menu_header 


Routines  Called: 

printf 

Parameters: 

INT  4 

r 

INT_4 

c 

Returns: 

none 

2.16.7.2  sgr 

The  sgr  function  is  used  for  special  graphics  renditions. 
The  function  call  is  sgr(v),  where  v  is  the  row  number. 
This  function  is  not  currently  used. 


Called  By: 

none 

Routines  Called: 

printf 

Parameters: 

INT_4 

V 

Returns: 

none 

2.16.7.3  double_top 

The  double_top  function  represents  double-wide,  double-high  for  the  top  half  of  the 
monitor  screen. 

The  function  call  is  doubIe_top(s),  where  s  is  the  starting  line. 
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This  function  is  not  currently  used 


Called  By: 

none 

Routines  Called: 

printf 

Parameters: 

BYTE 

s 

Returns: 

none 

2.16.7.4  double_bot 

The  double_bot  function  represents  double-wide,  double-high  for  the  bottom  half  of  the 
monitor  screen. 

The  function  call  is  doubIe_bot(s),  where  s  is  the  starting  line. 

This  function  is  not  cunrently  used. 


Called  By: 

none 

Routines  Called: 

printf 

Parameters: 

BYTE 

s 

Returns: 

none 

2.16.7.5  double_off 

The  double_off  function  returns  to  single-high  and  single-width.  This  reverses  the  effect 
of  double_top  and/or  double_bot. 

The  function  call  is  double_off(). 

This  function  is  not  currently  used. 


Called  By: 

none 

Routines  Called: 

printf 
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Parameters:  none 

Returns:  none 

2.16.7.6  blank 

The  blank  function  clears  the  screen  from  a  given  starting  position. 

The  function  call  is  blank(m),  where  m  is  the  character  position  from  which  the  screen  is 
to  be  blanked. 


Called  By:  flea_agpt_locations_main_menu 

flea_agpt_switches_main_nienu 
flea_atp_main_menu 
flea_bd_opts 
flea_bal_opts_main_menu 
flea_graphics_test_main_menu 
flea_switches 
flea_switches_main_menu 
flea_veh_controI 
flea_veh_control_main_menu 
gos_db_query 
gos_db_query_menu 
gos_main_menu 
gos_ppm_query 
gos_ppm_query_menu 
gossip_tick 

host_if_debug_main_menu 

host_if_display_enabled_nisgs 

host_list_msgs 

model_demo 

tick 

tick_main_menu 

tick_ppm 

tick_ppm_menu 

tick_scripi 

tick_script_main_menu 


Routines  Called: 

printf 

Parameters: 

INT_4 

m 

Returns: 

none 

2.16.7.7  save_cur 

The  save_cur  function  saves  the  current  cursor  position. 
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The  function  call  is  save_cur(). 
This  function  is  not  currently  used. 


Called  By: 

none 

Routines  Called: 

printf 

Parameters: 

none 

Returns: 

none 

2.16.7.8  restore_cur 

The  rcstore_cur  function  restores  the  cursor  position  to  the  location  saved  by  save_cur. 
The  function  call  is  restore_cur(). 

This  function  is  not  cunently  used. 


Called  By: 

none 

Routines  Called: 

printf 

Parameters: 

none 

Returns: 

none 

2.16.7.9  scroIl_reg 

The  scroll_reg  function  sets  the  top  and  bottom  boundaries  of  the  scrolling  region. 

The  function  call  is  scron_reg(t,  b),  where: 

t  is  the  top  of  the  scroll  region 
b  is  the  bottom  of  the  scroll  region 

This  function  is  not  currently  used. 

Called  By:  none 
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Routines  Called:  printf 


Parameters; 


INT_4 

INT_4 


Returns; 
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2.17  Viewport  Configuration  (/cig/libsrc/libvpt) 

The  Viewport  Configuration  CSC  is  responsible  for  initializing  and  building  the 
configuration  tree  before  runtime.  The  configuration  tree  describes  the  relationship 
between  the  physical  components  of  the  simulated  vehicle  and  the  location  of  the 
viewports.  The  data  used  to  set  up  the  configuration  tree  is  input  via  messages  received 
from  the  Simulation  Host. 

The  configuration  tree  consists  of  the  following: 

•  One  root  node,  which  marks  the  start  of  the  configuration  tree.  This  node  contains 
no  data  and  must  be  the  first  node  created. 

•  One  or  more  matrix  nodes,  each  of  which  contains  a  transformation  matrix  that 
specifies  rotation  angles  (heading,  pitch,  and  roll)  and  translation  values.  The 
matrices  in  all  nodes  in  a  traversd  path  of  the  tree  are  concatenated  to  generate  the 
view  of  the  world  for  the  viewport  represented  by  that  path.  Matrix  nodes  are 
designated  as  either  dynamic  (ones  that  are  updated  during  the  simulation)  or  static 
(ones  that  do  not  change  during  the  simulation). 

•  Zero  or  more  conditional  (branch)  nodes,  each  of  which  branch  into  one  of  two 
traversal  paths  based  on  a  runtime  condition.  The  node  branched  to  if  the  condition 
is  true  is  the  conditional  node's  "true  child"  and  the  node  branched  to  if  the 
condition  is  false  is  the  "false  child."  The  branch  values  are  stored  in  the  system 
view  flags  array.  The  branch  values  in  effect  at  any  given  time  in  the  simulation  are 
set  via  messages  sent  from  the  Simulation  Host. 

•  Viewport  parameters  for  each  viewport.  These  parameters  are  the  screen 
resolution,  viewing  range,  near  plane,  field-of-view  angles,  level-of-detail 
multiplier,  and  aspect  ratio  (currently  not  used).  Viewport  parameters  are 
associated  with  the  final  node  in  each  traversal  path  in  the  configuration  tree. 

Note  that  the  same  viewport  may  be  defined  multiple  times,  each  with  different 
parameters.  A  conditional  node  enables  a  change  to  new  viewport  parameters 
during  the  simulation. 

•  One  or  more  sets  of  graphics  path  parameters  for  each  viewport.  A  graphics  path  is 
a  window  on  a  viewport.  On  a  T  backend,  there  is  one  graphics  path  per  viewport. 
On  a  TX  backend,  there  are  two  or  four  graphics  paths  per  viewport,  depending  on 
the  resolution.  The  graphics  path  parameters  are  used  to  load  the  hardware. 

The  structure  of  the  configuration  tree  cannot  be  changed  during  runtime  —  all  nodes  and 
viewport  definitions  must  be  created  at  CIO  initialization  time.  However,  various 
parameters  within  the  configuration  tree  do  change  during  the  simulation.  Therefore,  some 
Viewport  Configuration  functions  are  called  to  update  configuration  tree  structures  during 
runtime. 

Specifically,  messages  can  be  used  to  update  the  following  structures  after  the 
configuration  tree  has  been  created; 

•  Dynamic  matrices.  The  Simulation  Host  can  provide  a  new  matrix  or  a  change 
(e.g.,  rotation)  to  the  current  matrix. 
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•  Branch  values  for  conditional  nodes.  Changing  the  branch  values  during  a 
simulation  causes  selection  of  a  different  traversal  path  and,  typically,  different 
viewport  parameters. 

•  Certain  viewport  parameters  (the  level-of-detail  multiplier  and  the  field-of-view 
angles).  Although  a  message  is  available  to  change  these  parameters  directly,  it  is 
recommended  that  all  desirable  viewptwt  parameter  combinations  be  built  into  the 
configuration  tree  and  selected  using  branch  values. 

The  configuration  tree  can  contain  a  maximum  of  64  nodes.  Each  node  is  referenced  by  a 
unique  index,  which  is  used  in  messages  sent  to  update  the  node  during  the  simulation. 

The  root  node  is  always  assigned  node_index  0.  A  node  that  has  viewport  parameters 
attached  to  it  must  have  a  node_index  between  1  and  31. 

Every  matrix  node  in  the  configuration  tree  must  be  defined  in  one  of  two  formats:  RTS4x3 
(4x3  rotation  translation  scale)  or  HPRXYZS  (3x3  scale  heading  pitch  roll  translation). 

A  matrix  node's  format  can  be  redefined  during  the  simulation. 

The  format  of  each  of  these  matrix  structures  is  as  follows: 


RTS4x3  (4x3  rotation  translation  scale) 
The  matrix  format  is: 


rotation[0,0] 

rotation[l,0] 

rotation[2,0j 

translation.x 


rotation[0,l] 

rotation[l,l] 

rotation[2,l] 

translation.y 


rotation[0,2] 

rotation[l,2] 

rotation[2,2] 

translation.z 


where: 

rotation  is  an  angle  in  degrees 
translation  is  a  distance  in  meters 

The  typedef  for  this  matrix  structure  is: 


typedef  struct  { 

REAL_4  rotation [3] [3] ; 

R4P3D  translation; 

}  RTS4x3  MTX; 


HPRXYZS  (3x3  scale  heading  pitch  roll  translation) 
The  matrix  format  is: 


heading 
translation.x 
scale.x 
scale  order 
roll  order 


pitch 

translation.y 
scale.y 
heading  order 
translate  order 


where: 

heading  =  -yaw  =  -z  rotation  in  degrees 
pitch  =  X  rotation  in  degrees 
roll  =  y  rotation  in  degrees 
translation  is  a  distance  in  meters 


roll 

translation.z 
scale.z 
pitch  order 
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scale  is  a  scaling  factor  (used  to  enlarge  or  reduce  matrices) 
the  order  values  specify  the  order  in  which  the  matrices  are  to  be 
concatenated 

The  typedef  for  this  matrix  structure  is: 

typedef  struct  { 

REAL_4  heading; 

REAL_4  pitch; 

REAL_4  roll; 

R4P3D  translation; 

R4P3D  scale; 

UNS_1  concat_order [5] ; 

)  RTS3x3_MTX; 

A  third  matrix  format,  ROT2xl  (2x1  rotation),  can  be  used  to  rotate  a  matrix  along 
one  axis.  Matrix  nodes  cannot  be  defined  as  this  matrix  format,  although  they  can  be 
updated  by  it  The  matrix  format  for  ROT2xl  is: 

cos(rotation  O)  sin(rotation  ®) 
rotation  axis 


where: 

rotation  is  the  angle  of  rotation  in  degrees 

rotation  axis  is  the  axis  along  which  rotation  is  to  occur:  0  (x),  1  (y),  or  2  (z) 

The  typedef  for  this  matrix  stmeture  is: 

typedef  struct  { 

REAL_4  cos_rotation; 

REAL_4  sin_rotation; 

UNS_1  rotation_axis; 

UNS_1  unused [3]; 

)  ROT2xl  MTX; 


The  functions  in  the  Viewport  Configuration  CSC  do  the  following: 

•  Create  all  configuration  nodes,  viewport  parameter  entries,  and  graphics  path 
entries,  based  on  data  received  from  the  Simulation  Host. 

•  Generate  DTP-style  matrices  from  the  matrices  provided  by  the  Simulation  Host. 

•  Generate  DTP  code  for  the  overlays. 

•  Process  the  system  view  flags/branch  values  and  load  them  into  the  T&C  (Timing 
and  Control)  board. 

•  Provide  an  interface  to  the  Gossip  user  to  test  the  viewport  configuration  process 
without  connection  to  a  Simulation  Host. 

The  configuration  tree  is  built  according  to  messages  received  from  the  Simulation  Host. 

To  initiate  this  process,  db_mcc_setup  (in  the  Real-Time  Processing  CSC)  calls  the 
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cig_config  function  (in  the  CIG  Configuration  CSC).  cig_config  in  turn  calls  the  Viewport 
Configuration  functions  to  configure  tiie  nodes,  viewports,  and  graphics  paths. 

Most  of  the  CSUs  in  the  Viewport  Configuration  CSC  fall  into  one  of  the  following 
groups: 

cnode_*  CSUs 

Contain  functions  that  operate  on  configuration  nodes, 
vpt  *  CSUs 

r^ontain  functions  that  operate  on  nodes  that  have  viewport  parameters  attached  to 
them. 

mtx  *  CSUs 

Contain  functions  that  perform  matrix-specific  operations. 
path_*  CSUs 

Contain  functions  that  operate  on  graphics  path  parameters. 
tst_*  CSUs 

Contain  functions  useful  for  testing  the  viewport  configuration  process.  These 
include  a  routine  that  can  be  used  to  create  the  tree  fiom  data  in  an  ASCII  file 
created  offline. 

u_*  CSUs 

~  Contain  the  update  functions  used  to  actually  modify  the  viewport  objects.  These 
routines  are  called  by  the  other  Viewport  Configuration  CSUs. 

Many  of  the  function  names  are  preceded  with  vpt_  followed  by  the  CSU  type.  For 
example,  most  of  the  functions  that  deal  with  configuration  nodes  begin  with  vpt_cnode. 
Similarly,  most  of  the  update  functions  begin  with  vpt_update. 

Figure  2-21  identifies  the  CSUs  in  Viewport  Configuration.  The  functions  performed  by 
these  CSUs  are  described  in  this  section. 
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be_stubs.c 

cnode_child.c 

cncxje_jget.c 

cnocle_process.c 

cnode_query.c 

cnode_set.c 

flagoff.c 

globs.c 

init_free.c 

linkvpt.c 

mtx_concat.c 

mtx_dump.c 


mtx_viewspace.c 

path.c 

pathjnit.c 

path_query.c 

trav_tree.c 

tst_edebug.c 

tst_equery.c 

tst_ereadconfig.c 

tst_eupdate.c 

tstjree.c 

tstjreetrace.c 

u  brmaske 


u_path.c 

u_rotations.c 

u_viewport.c 

u_xfrm.c 

update_mtx.c 

update_rot.c 

vpt_get.c 

vpt jarocess.c 

vpt_query.c 

vpt_set.c 

vpt_update.c 


Figure  2-21.  Viewport  Configuration  CSUs 


2.17.1  be  stubs. c 


The  functions  in  the  be_stubs.c  CSU  are  used  to  interface  to  the  backend.  These  functions 
are  the  following: 


•  be_query_num_paths 

•  find_be_id 

•  be_query_buffer_offset 

•  be_qulm 

•  be_query_lm_per_lmb_side 

•  vpt_init_mode_on 

•  vpt_init_mode_off 

•  aam  free 


2.17.1.1  be_query_nuin_paths 

The  be_query_num_paths  function  determines  the  number  of  graphics  path  required  to 
build  a  viewport  This  function  is  called  when  viewport  parameters  are  created  for 
configuration  nodes. 

The  function  call  is  be_query_num_paths(vpt_id,  n_vpts,  res  i,  resj,  num_pi, 
num_pj,  start_p),  where: 
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vpt  id  is  the  viewport  identifier 

n  vpts  is  the  number  of  viewports 

res  j  is  the  number  of  pixels  in  each  row  (horizontal) 

res  J  is  the  number  of  pixels  in  each  column  (vertical) 

num _pi  is  a  pointer  to  the  number  of  paths  in  the  i  direction 

nwn _pj  is  a  pointer  to  the  number  of  paths  in  the  j  direction  (currently  always  1) 

start _p  is  a  pointer  to  the  starting  path  id 

be_query_num_paths  does  the  following: 

•  Calls  find_be_id  to  get  the  viewport's  backend  id. 

•  (Halls  backend_get_object_addr  to  get  the  address  of  the  backend. 

•  For  a  TX  backend,  sets  the  number  of  graphics  paths  to  1, 2,  or  4  based  on  the 
desired  resolution  and  the  number  of  viewports. 

•  For  a  T  backend,  sets  the  number  of  graphics  paths  to  1 . 

•  Determines  the  start  path  id  based  on  which  backend  the  viewport  is  in,  the  type  of 
backend,  and  the  resolution. 

•  Sets  the  remaining  values. 

The  function  returns  SUCCEED  if  it  is  successful.  It  returns  FAIL  if  the  backend  identifier 
is  invalid  or  the  backend  could  not  be  found. 


Called  By: 

vpt_vpt_process 

Routines  Called: 

backend_get_object_addr 

find_bejd 

printf 

Parameters: 

INT  2 

vpt_id 

INT  2 

n_vpts 

INT  4 

res_i 

INT  4 

resJ 

INT  2 

*num_pi 

INT  2 

*num_pj 

INT  2 

*start_p 

Returns:  1  (SUCCEED) 

0(FAIL) 


2.17.1.2  find_be_id 

The  find_be_id  function,  given  a  viewport  id,  returns  the  corresponding  backend  id.  It 
returns  0  if  the  viewport  id  is  between  0  and  7, 1  if  the  viewport  id  is  between  8  and  15, 
and  -1  (an  error)  if  the  viewport  id  is  anything  else. 

The  function  call  is  find_be_id(vpt),  where  vpt  is  the  viewport  id. 


Called  By:  be_query_num_paths 
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Routines  Called: 


none 


Parameters:  INT_2 


vpt 


Returns;  0 

1 

-1 


2.17.1.3  be_query_buffer_offset 

The  be_query_buffer_offset  function  returns  the  offset  to  the  current  double  buffer.  The 
offset  is  0  if  DBO  is  current,  or  the  size  of  the  buffer  (DB_BUFSIZE)  if  DB 1  is  current. 

The  function  call  is  be  query_buffer_offset().  The  function  returns  the  offset  as 
temp.  If  vie>^p<^  initidization  mode  (vpt_init_mode)  is  TRUE,  indicating  that  viewport 
initialization  is  in  progress,  the  function  always  returns  0. 


Called  By: 

concat_mtx 

process_vflags 

process_vppos 

vpt_update_all 

vpt_update_fov 

vpt_update_fovJod 

vpt_update_lodm 

vpt_update_near_plane 

vpt_update_one_path 

vpt_update_rez 

vpt_update_view_range 

vptq_activevpt 

•  1 

j 

Routines  Called; 

none 

Parameters: 

none 

Returns: 

tanp 

2.17.1.4  be_query_ 

dbO 

The  be_query_dbO  function  returns  DBO. 

The  function  call  is  be_query_dbO(). 

Called  By; 

dtp_travl 

• 
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Routines  Called:  none 


Parameters: 

none 

Returns: 

DBO 

2.17.1.5  be_qulm 

The  be_qulm  function  returns  database-specific  load  module  data  for  a  specified  viewport. 
The  values  it  returns  are  the  the  inverse  of  the  load  module  block  width  and  the  number  of 
load  module  blocks  per  side  of  active  area  memory. 

The  function  call  is  be_qulm(vpt_id,  inv_Imb_width,  Iinb_per_side),  where: 
vptjd  is  the  viewport  id 

inv_lmb_width  is  a  pointer  to  the  nverse  of  the  width  of  a  load  module  block 
Imb  jjer  side  is  a  pointer  to  the  number  of  load  module  blocks  per  side  of  AAM 

be_qulm  determines  which  backend  the  viewport  is  in,  then  puts  the  data  into  the  locations 
passed  in  the  call. 


Called  By: 

dtp_trav2 

Routines  Called: 

none 

Parameters: 

INT  2 

vpt_id 

REAL  4 

*inv_lmb_width 

REAL_4 

*lmb_per_side 

Returns: 

none 

2.17.1.6  be_query_Iin_per_lmb_side 

The  be_query_lm_per_lmb_side  function  returns  the  number  of  load  modules  on  a  side  of  a 
load  module  block  for  a  given  database.  This  value  is  used  for  scaling  when  load  module 
blocking  is  enabled.  Usually,  the  value  is  1  for  3500-meter  (non-blocked)  databases  and  2 
for  7000-meter  (blocked)  databases. 

The  function  call  is  be_queryjm_per_lnib_side(vptjd),  where  vptjd  is  the 
viewport  id.  -----  _ 

The  function  determines  which  database  to  query  based  on  the  viewport  id,  then  returns  the 
result  as  temp. 
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Called  By: 
Routines  Called: 

Parameters: 

Returns: 


vpt_vpt_process 

none 

INT_2 

tanp 


vpt_id 


2.17.1.7  vpt_init_mode_on 

The  vpt_init_mode_on  function  sets  the  viewport  initialization  mode  (vpt_init_mode) 
variable  to  TRUE.  This  variable  indicates  whether  or  not  viewport  configuration  is  in 
progress.  vpt_init_mode_on  is  called  by  cig_config  before  it  starts  building  the 
configuration  tree. 

The  function  call  is  vpt_init_mode_on(backend),  where  backend  is  the  id  of  the 
backend  to  be  initialize.”  ”  ” 

The  function  also  sets  the  init_backend  variable  to  the  specified  bacicend. 


Called  By: 

cig_config 

Routines  Called: 

none 

Parameters: 

INT_4 

backend 

Returns: 

none 

2.17.1.8  vpt_init_mode_off 

The  vpt_init_mode_off  function  sets  the  viewport  initialization  mode  (vpt_init_mode) 
variable  to  FALSE.  This  variable  indicates  whether  or  not  viewport  configuration  is  in 
progress.  vpt_init_mode_off  is  called  by  cig_config  after  the  configuration  tree  has  been 
built  and  the  DTP  compiler  has  finished. 

The  function  call  is  vpt_init_mode_off(). 


Called  By:  cig_config 

Routines  Called:  none 
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Parameters:  none 


Returns:  none 


2.17.1.9  aam_free 

The  aam_free  function  is  a  dummy  function  that  performs  no  action.  This  function  is  used 
to  «TBD». 

The  function  call  is  aam_free(ptr),  where  ptr  is  the  location  to  be  freed. 

Called  By:  vpt_tree_free 

Routines  Called:  none 


Parameters:  UNS_1  *ptr 

Returns:  none 


2.17.2  cnode_child.c 

The  functions  in  the  cnode_child.c  CSU  are  used  to  add  branch  and  standard  (matrix)  child 
nodes  to  the  configuration  tree  at  initialization  time.  These  functions  are: 

•  vpt_cnode_set_bchild 

•  vpt_cnode_set_stdchild 


2.17.2.1  vpt_cnode_set_bchild 

The  vpt_cnode_set_bchild  function  adds  branch  child  nodes  (the  children  of  branch  nodes) 
to  the  configuration  tree. 

The  function  call  is  vpt_cnode_set_bchild(new_node,  parent_node, 
true_child_flag),  where: 

new  node  is  a  pointer  to  the  new  child  node 
parent  node  is  a  pointer  to  the  child's  parent  node 

true  child  Jlag  indicates  whether  this  is  the  branch  node's  true  child  or  the  false  child 
vpt_cnode_set_bchild  does  the  following: 

•  For  a  true  child,  puts  the  pointer  to  the  child  in  the  parent's  true  child  slot,  or 
outputs  an  error  if  this  slot  is  already  filled. 

•  For  a  false  child,  puts  the  pointer  to  the  child  in  the  parent's  false  child  slot,  or 
outputs  an  error  if  this  slot  is  already  filled. 
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Called  By:  vpt_cnode_process 


Routines  Called:  printf 

vpti_state_dcnode  (in  debug  mode  only) 


Parameters: 


CONHGURATION.NODE 

CONHGURATION_NODE 

UNS_1 


*new_node 

*parent_node 

true_child_flag 


Returns:  none 


2.17.2.2  vpt_cnode_set_stdchild 

The  vpt_cnode_set_stdchild  adds  matrix  child  nodes  (the  children  of  matrix  nodes)  to  the 

configuration  tree. 

The  function  call  is  vpt_cnode_set_stdchild(new_node,  parent_node),  where: 

new  node  is  a  pointer  to  the  new  child  node 

parent  node  is  a  pointer  to  the  child's  parent  node 

vpt_cnode_set_stdchild  does  the  following: 

•  If  the  parent's  first  child  slot  is  empty,  (i.e.,  the  parent  has  no  other  children),  puts 
a  pointer  to  the  child  in  that  slot 

•  If  the  parent's  first  child  slot  is  filled  (i.e,  the  parent  has  at  least  one  other  child), 
traverses  down  the  parent  node's  sibling  list.  Puts  a  pointer  to  the  new  node  in  the 
sibling  pointer  slot  of  the  last  sibling. 


Called  By:  vpt_cnode_process 


Routines  Called:  printf  (in  debug  mode  only) 

vpti_state_dcnode  (in  debug  mode  only) 


Parameters:  CONFIGURATION_NODE  *new_node 

CONFIGURATION_NODE  *parent_node 


Returns:  nv^ne 


2.17.3  cnode_get.c  (vpt_cnode_get) 

The  vpt_cnode_get  function  allocates  memory  for  a  configuration  node  and  returns  a 
pointer  to  that  node.  This  function  is  called  by  vpt_cnode_process  each  time  it  adds  a  new 
node  to  the  configuration  tree. 
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The  function  call  is  vpt  cnode_get(node_index),  where  nodejndex  is  the  index  of  the 
node  for  which  a  pointerls  to  be  returned. 

vpt_cnode_get  does  the  following: 

•  Verifies  that  the  node_index  is  valid  and  the  array  can  hold  another  pointer. 

Outputs  an  error  if  the  node  cannot  be  added. 

•  Calls  vpti_get_ptr_cnode  to  make  sure  this  node  does  not  already  have  a  pointer  set 
to  it  Outputs  an  error  if  it  has. 

•  Calls  calloc  to  allocate  memoiy  for  this  configuration  node. 

-  If  memory  is  available,  calls  vpti_set_ptr_cnode  to  add  the  pointer  to  the 
node  pointers  allocation  table  (Gvpt_cnode_pointCTs). 

-  If  not  enough  memory  is  available,  outputs  an  error. 

The  function  returns  the  pointer  assigned  to  the  node  as  cnode. 


Called  By: 


vpt_cnode_process 


Routines  Called:  calloc 

printf 

vpti_get_ptr_cnode 

vpti_set_ptr_cnode 


Parameters:  INT_2  node_index 


Returns:  cnode 


2.17.4  cnode_process.c  (vpt_cnode_process) 

The  vpt_cnode_process  function  is  responsible  for  placing  all  configuration  node 
information  into  the  configuration  tree.  This  function  is  called  by  cig_config  when  the 
Simulation  Host  sends  a  MSG_CREATE_CONFIGNODE  message.  Based  on  the  node's 
type,  vpt_cnode_process  calls  the  appropriate  function  to  add  the  new  node. 

The  function  call  is  vpt_cnode_process(node  index,  parent  index,  node_type, 
matrix_type,  true_child_flag,  static_nitx_fiag,  branch_index,  branch  mask, 
matrix,  description),  where: 

node  jndex  is  the  unique  index  used  to  reference  this  node 
parent  index  is  the  node_index  of  this  node’s  parent  node 

node  type  is  0  (matrix  node),  1  (branch  node),  or  2  (branch/matrix  node  —  for  future 
expansion) 

matrix  type  is  0  (HPRXYZS  matrix)  or  1  (RTS4x3  matrix);  matrices  cannot  be  defined 
as  2  (ROT2xl  matrix) 

true  child  Jlag  is  0  (false  child  of  a  branch  node)  or  1  (true  child  of  a  branch  node) 
staticjntx Jlag  is  0  (dynamic  node,  matrix  will  move  in  runtime)  or  1  (static  node, 
matrix  will  not  change  during  the  simulation) 
branch  index  is  the  node's  index  into  the  branch  value  array  (for  branch  nodes  only) 
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branch  mask  is  the  node's  branch  mask  (branch  values  for  a  branch  node,  values 
controlling  overlay  placement  for  a  matrix  node) 
matrix  is  the  node's  initial  rotation  matrix 
description  is  a  text  string  describing  the  node 

vpt_cnode_process  does  the  following: 

•  ClaUs  vpt_cnode_^et  to  get  a  pointer  to  the  new  node. 

•  Copies  the  node  index,  t>  pe,  and  description  to  the  new  node  entry. 

•  If  this  is  the  root  node  (node_index  =  0): 

-  Resets  the  vehicle_id. 

-  Calls  vpt_root_init  to  initialize  the  root  node,  view  positions  array,  and  view 
flags  array. 

-  Returns  the  status  returned  by  vpt_root_init. 

•  If  this  is  a  child  node: 

-  Loads  the  parent  index  into  the  node  entry. 

-  Calls  vpti_get_ptr_cnode  to  get  the  pointer  for  the  parent  node,  and  loads  it 
into  the  node  entry. 

-  If  the  parent  is  a  branch  node,  calls  vpt_cnode_set_bchild  to  add  the  new 
child  node. 

-  If  the  parent  is  a  matrix  node,  calls  vpt_cnode_set_stdchild  to  add  the  new 
child  node. 

•  If  this  is  a  matrix  node: 

-  Calls  vpt_cnode_set_matrix  to  generate  the  node's  matrix  and  load  it  into 
active  area  memory. 

•  If  this  is  a  branch  (conditional)  node: 

-  Calls  vpt_cnode_set_branch  to  add  the  node's  branch  index  and  branch 
mask,  and  to  set  a  pointer  to  the  view  flagsA)ranch  value  array. 

•  If  this  is  a  child  of  the  root  node  (i.e.,  a  world/hull  matrix  node): 

-  Assigns  the  next  vehicle  id  and  sets  it  in  the  node  entry. 

-  Calls  process_vppos  to  load  the  vehicle's  current  position. 

The  function  returns  SUCCEED  if  the  node  is  added  to  the  configuration  tree  successfully. 
It  returns  FAIL  if  memory  could  not  be  allocated  for  the  new  node,  or  if  one  of  the  called 
routines  could  not  add  the  node  for  any  reason. 


Called  By:  cig^config 

p_configtree_node 


Routines  Called:  printf 

process_vppos 

strcpy 

vpt_cnode_get 

vpt_cnode_set_bchild 

vpt_cnode_set_te’anch 

vpt_cnode_set_matrix 

vpt_cnode_set_stdchild 

vpt_root_init 

vpti_get_ptr_cnode 

vpti_state_dcnode  (in  debug  mode  only)) 
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Parameters; 

INT  2 

node_index 

INT  2 

parent_index 

UNS  1 

node_type 

UNS  1 

matrix_type 

UNS  1 

true_child_fla 

UNS  1 

static_mtx_fla 

UNS  1 

branch_index 

UNS  4 

branch_mask 

MTXUNION 

♦matrix 

UNS_1 

description[] 

Returns: 

1  (SUCCEED) 

0  (FAIL) 

2.17.5  cnode_query.c 

The  functions  in  the  cnode_query.c  CSU  are  used  to  read  configuration  node  data.  These 
functions  are; 

•  vpt_cnode_query 

•  vpt_cnode_qroot 


2.17.5.1  vpt_cnode_query 

The  vpt_cnode_query  function  copies  information  from  the  configuration  node  structure  to 
a  query  structure.  This  function  is  used  in  testing  only. 

The  function  call  is  vpt_cnode_query(cp,  cl),  where: 

cp  is  a  pointer  to  the  configuration  node 
d  is  a  pointer  to  the  information  structure 

vpt_cnode_query  does  the  following: 

•  Initializes  the  query  information  structure. 

•  Puts  all  data  from  the  configuration  node  (node  index,  parent  index,  matrix  type, 
etc.)  into  the  query  information  structure. 


Called  By;  tst_treetrace 

vptq_brvals 
vptq_cnout 
vptq_dynmtx 


Routines  Called:  none 


Parameters:  CONFlGURATION_NODE 

VPT_CNODE_INFO 


*cp 

*ci 
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Returns:  none 


2.17.5.2  vpt_cnode_qroot 

The  vpt_cnode_qroot  function  returns  a  pointer  to  the  root  node,  which  it  finds  by  calling 
vpti_get_ptr_cnode. 

The  function  call  is  vpt_cnode_qroot(). 


Called  By: 


dtp_conipiler 

process_vflags 

process_vppos 

vptq_activept 


Routines  Called: 

Parameters: 


vpti_get_ptr_cnode 


none 


Returns: 


vpti_get_ptr_cnode(0) 


2.17.6  cnode_set.c 

The  functions  in  the  cnode_set.c  CSU  are  used  to  add  branch  and  matrix  node  parameters 
to  the  configuration  tree.  These  functions  are: 

•  vpt_cnode_set_branch 

•  vpt_cnode_set_matrix 


2.17.6.1  vpt_cnode_set_branch 

The  vpt_cnode_set_braiich  function  sets  the  special  parameters  that  pertain  only  to  branch 
(conditional)  nodes.  This  function  is  called  by  vpt_cnode_4)rocess  when  adding  a  branch 
node  to  the  configuration  tree. 

The  function  call  is  vpt_cnode_set_branch(new_node,  branch_mask, 
branch_index),  where:  ~ 

new  node  is  a  pointer  to  the  new  node's  entry  in  the  configuration  tree 
branch  mask  is  the  node's  branch  mask 
branchjndex  is  the  index  into  the  branch  value  array 

vpt_cnode_set_branch  does  the  following: 

•  Puts  the  node's  branch  mask  into  the  node  entry. 
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•  Determines  the  node’s  branch  value  pointer  by  using  its  node  index  to  index  into  the 
branch  value  array.  (The  address  of  this  array  is  stored  in  the  root  node's  branch 
value  pointer.) 

•  Puts  the  node's  branch  value  pointer  into  the  node  entry. 


CMed  By:  vpt_cnode_process 


Routines  Called:  printf  (in  debug  mode  only) 

vpti_get_ptr_cnode 

vpti_state_dcnode  (in  debug  mode  only) 


Parameters: 


CONHGURATION.NODE*  new.node 

UNS_4  branch_mask 

UNS_1  branch_index 


Returns:  none 


2.17.6,2  vpt_cnode_set_matrix 

The  vpt_cnode_set_matrix  function  sets  the  special  parameters  required  for  matrix  nodes, 
generates  the  DTP  matrix,  and  loads  the  matrix  into  active  area  memory.  This  function  is 
called  by  vpt_cnode_process  when  adding  a  matrix  node  to  the  configuration  tree. 

The  function  call  is  vpt  cnode_set_matrix(new_node,  matrix_type, 
static_mtx_flag,  matrix,  branchjmask),  where: 

new  node  is  a  pointer  to  the  new  node  entry 
matrix  type  is  0  (HPRXYZS  matrix)  or  1  (RTS4x3  matrix) 
static  jntx  Jlag  is  0  (dynamic  node,  matrix  will  move  in  runtime)  or  1  (static  node, 
matrix  will  not  change  during  the  simulation) 
matrix  is  the  node's  initial  rotation  matrix 

branch  rnask  is  the  nooe's  branch  mask  (used  to  indicate  whether  or  not  overlays  are  to 
be  displayed  on  the  viewport) 

vpt_cnode_set_matrix  does  the  following: 

•  Puts  the  matrix  type  and  static  matrix  flag  into  the  new  node's  entry. 

•  Allocates  memory  for  the  matrix  in  the  n^e. 

•  Allocates  memory  for  the  DTP  matrix  in  active  area  memory. 

•  Makes  a  copy  of  the  matrix. 

•  Allocates  memory  for  a  copy  of  the  matrix  (for  dynamic  matrices  only),  for  use  in 
teirain  feedback  processing. 

•  Calls  concat_mtx  to  generate  the  DTP-style  matrix  and  load  it  into  active  area 
memory. 

•  Puts  the  node's  branch  mask  into  the  node  entry. 

The  function  returns  SUCCEED  if  the  matrix  data  was  generated  successfully.  It  returns 
FAIL  if  memory  could  not  be  allocated  for  the  node  matrix,  the  DTP  matrix,  or  the  copy  of 
the  dynamic  matrix. 
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Called  By: 

vpt_cnode_process 

• 

Routines  Called: 

aam_malloc 

calloc 

concat_mtx 

mtxcpy 

printf 

r4mat_dump 

vpti_state_dcnode 

(in  debug  mode  only) 

(in  debug  mode  only) 

Parameters: 

CONnGURATION  NODE* 
UNS  1 

UNS  1 

UNS  4 

MTXUNION 

new_node 

matrix_type 

static_mtx_flag 

branch_mask 

♦matrix 

Returns: 

1  (SUCCEED) 

0(FAIL) 

i 

i 

2.17.7  flagoff.c 

i 

The  flagoff  function  turns  off  all  Viewport  Configuration  debug  flags.  This  function  is 
called  by  cig_config  (in  the  CIG  Configuration  CSC)  when  it  processes  the  CIG  Control- 
Stop  message  after  the  configuration  tree  has  been  built. 

• 

The  function  call  is  flagoff().  flagoff  sets  Gvpt_dtree_short  to  TRUE  and  sets  the 
following  variables  to  FALSE: 

•  Gvpt_dmatrix 

•  Gvpt_dvptnode 

•  Gvpt_dpath 

•  Gvpt_dlodmult 

•  Gvpt_dcnode 

•  Gvpt_state_dtproc 

•  Gvpt_state_efillt 

•  Gvpt_state_edtpc 

These  variables  are  maintained  using  the  functions  in  globs.c.  For  definitions  of  the 
variables,  see  globs.c. 

Called  By: 

cig_config 

Routines  Called: 

vpti_set_state_dcnode 

vpti_set_state_dlodmult 

vpti_set_state_dmatrix 

vpti_set_state_dpath 

• 
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vpti_set_state_dtproc 

vpti_set_state_dtree_short 

vpti_set_state_dvpmode 

vpti_set_state_edtpc 

vpti_set_state_efilJt 


Parameters:  none 


Returns:  none 


2.17.8  globs.c  (vpti_*) 

The  globs.c  CSU  contains  functions  that  manage  the  global  variables  that  keep  track  of 
Viewport  Configuration  status.  These  functions  can  be  used  to  obtain  the  current  value  of  a 
variable  or  to  change  the  variable's  setting. 

The  Viewport  Configuration  variables  that  can  be  managed  using  these  routines  are  listed  in 
the  following  table. 
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Variable 

Type 

Description  I 

Gvptjdcnode 

BOOLEAN 

If  TRUE  and  if  debug  mode  is  enabled,  status  and 
infonnation  messages  are  output  when  nodes  are 
configured. 

Gvpt_dlodmult 

BOOLEAN 

«TBD».  This  variable  is  used  by  test  routines 
only. 

Gvpt_dmatrix 

BOOLEAN 

If  TRUE  and  if  debug  mode  is  enabled,  status  and 
infonnation  messages  are  output  when 
configuration  node  matrices  are  manipulated. 

Gvpt_dpath 

BOOLEAN 

If  TRUE  and  if  debug  mode  is  enabled,  status  and 
information  messages  are  output  when  graphics 
path  parameters  are  configured 

Gvpt_d4woc 

BOOLEAN 

If  TRUE  and  if  debug  mode  is  enabled  status  and 
information  message  are  output  by  cig_conng  as  it 
processes  configuration  messages,  and  by  fill_tree 
as  it  sets  the  graphics  paths. 

Gvpt_dtree_shoit 

BOOLEAN 

If  TRUE,  the  information  displayed  through 

Gossip  for  a  configuration  node  is  reduced.  This 
variable  is  used  by  test  routines  only. 

Gvpt_dvptnode 

BOOLEAN 

If  TRUE  and  if  debug  mode  is  enabled,  status  and 
information  messages  are  output  when  viewport 
parameters  are  configured. 

Gvpt_edtpc 

BOOLEAN 

If  TRUE  and  if  debug  mode  is  enabled,  cig_config 
exits  before  calling  dlp_compDer. 

Gvpt_efillt 

BOOLEAN 

If  TRUE  and  if  debug  mode  is  enabled,  cig_config 
exits  before  calling  fill_tree. 

Gvpt_panel_align 

BOOLEAN 

«TBD» 

Gvpt_path_entry_index 

INT_2 

TTie  index  of  the  current  entry  in  the  graphics  path 
pointer  table. 

Gvpt_vpt_entry_index 

INT_2 

The  index  of  the  current  entry  in  the  viewport 
pointer  table. 

Gvpt_cnode_pointers[  ] 

CONHGURATION  - 
NODE 

Array  of  pointers  to  all  configuration  nodes. 

Gvpt_path_pointers[  ] 

GRAPHICS  PATH  - 
PARAMETERS 

Array  of  pointers  to  all  gr^hics  path  parameter 
entries. 

Gvpt_vpt_pointers[  ] 

VIEWPORT  - 
PARAMETERS 

Array  of  pointers  to  all  viewport  parameter  entries. 

The  routines  in  globs.c  are  summarized  in  the  following  table.  The  first  column  shows  the 
function's  name  and  parameters.  The  second  column  describes  the  function's  purpose. 
The  third  column  identifies  the  function(s)  that  call  this  routine.  The  functions  are  listed  in 
alphabetical  order,  not  the  order  in  which  they  appear  in  the  globs.c  file. 
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globs.c  Function 

Description 

Called  By 

vpti_change_path_entry_index 

(value) 

Sets  Gvpt_path_entry_index  to  the 
^)ecil!ed  value. 

vpt_tree_init 

vpti_change_vpt_cntry_index 

(value) 

Sets  Gvpt_vpt_cntry_index  to  the 
^)ecified  value. 

vpt_tree_init 

vpti_get_pathptr_cno(le 

(cnode_index) 

Returns  Gvpt_cnode_pomters 
[cnode_index]->view_param_ptr-> 
path_param_ptr.  Returns  0  if 
cnode  index  is  invalid. 

none 

vpti_get_ptr_cno<te(index) 

Returns 

G  vpt_cnode_pointers[index] . 

Returns  0  if  index  is  invalid. 

gosjocate,  tst_treetrace, 
vpt_vpt_set,  vpt_cnode_get, 
vpt_cnode_piocess, 
vpt_cnode_qioot, 
vpt_cnode_set_lManch, 
vpt_cnode_linkvpt, 
vpt_update_intx,  vpt_update_rot, 
vpt_uixlate_bnnask, 
vpt_iq)date_one_path,  vpt_tree_free, 
vpt_root_init,  vptq_dynmtx, 
vptq_cnout,  vptq_cnptrs, 
vptq_brvals 

vpti_get_ptr_path(index) 

Returns  Gvpt_path  jx)inters 
[index].  Returns  0  if  index  is 
invalid. 

fill_lree,  vpt_tree_free,  vptq  prptrs. 
vptq_grout 

vpti_get_ptr_vpt(index) 

Returns  Gvpt_vpt_pointers  [index]. 
Returns  0  if  index  is  invalid. 

vpt_tree_free,  trav_tree,  vpttLvpout, 
vptq_vpptrs,  vptq_vptbrout, 
vptq_activevpt 

vpti_get_vptptr_cnode 

(cnode_index) 

Returns  Gvpt_cnode_pointers 
[cnode_index]->view_param_ptr. 
Returns  0  if  cnode Jndex  is  invalid. 

vpt_update_all,  vpt_update_fov, 
vpt_update_fov_lod, 
vpt_iqxlate_rez,  vpt_update_lodm, 
vpt_update_near_plane, 
vpt_update_view_range 

vpu_incremeni_path_entry_ 
index  0 

Adds  1  to  Gvpt_path_entry_index. 

vpt_path _get 

vpti_inCTemeni_vpt_entry_ 

indexO 

Adds  1  to  Gvpt_vpt_entry_indcx. 

vpt_vpt_get 

vpti_set_ptr_cnode(index,  ptr) 

Sets  the  specified  index  in 
Gvpt_cnc>de_pointersG  to  the 
specified  pointer  (ptr). 

vpt_cnode_get,  vpt_tree_free, 
vpt_tree_init 

vpti_setjptr_path(index,  ptr) 

Sets  the  specified  index  in 
Gvpt_path_pointers[]  to  the 
specified  pointer  (ptr). 

vpt_tree_free,  vpt_tree_init, 
vpt_path_get 

vpu_set_ptr_vpt(index,  ptr) 

Sets  the  specified  index  in 
Gvpt_vpt_pointersD  to  the  specified 
pointer  (ptr). 

vpt_tree_free,  vpt_tree_init, 
vpt_vpt_get 

vpti_set_state_dcnode(value) 

Sets  Gvpt_dcnode  to  the  specified 
value. 

flagoff,  vpt_tree_init 

vpti_set_state_dlodniult(value) 

Sets  Gvpt_dlodmull  to  the  specified 
value. 

flagoff,  vpt_tree_inii 

vpti_set_state_dmatrix(value) 

Sets  Gvpt_dniatrix  to  the  specified 
value. 

flagoff,  vpt_tree_init 
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vpti_set_state_{^ath(value) 

Sets  Gvpt_dpath  to  the  specified 
value. 

flagoff,  vpt_tree_inil 

vpti_set_state_d5jroc(value) 

Sets  Gvpt_dtpioc  to  the  specified 
value. 

flagoff,  vpt_tree_inlt 

vpti_set_state_dlree_shcHt 

(value) 

Sets  Gvpt_dtree_short  to  the 
specified  value. 

flagoff,  vpt_tree_init 

vpti_set_state_dvptnode(value) 

Sets  Gvpt_dvptnode  the  specified 
value. 

flagoff,  vpt_tree_init 

vpti_set_state_edtpc(value) 

Sets  Gvpt.edqx;  to  the  specified 
value. 

flagoff,  vpt_tree_init 

vpti_set_state_efillt(  value) 

Sets  Gvpt_efillt  to  the  specified 
value. 

flagoff,  vpt_tree_init 

vpti_set_state_panel_align 

(value) 

Sets  Gvpt_panel_align  to  the 
specified  value. 

vpt_tree_init 

vpti_state_dcnodeO 

Returns  the  value  of  Gvpt_dcnode. 

vpt_cnode_process, 
vpt_cnode_set_bchlld, 
vpt_cnode_set_stdchlld, 
vpt_cnode_set_l»anch , 
vpt_cnode_set_matrix, 
vpt_update_intx,  vpt_update_rot, 
vpt_update_bnnask, 
p_conflgtree_node,  tsl_edebug. 

vpti_state_dlodmultO 

Returns  the  value  of 

Gvpt_dlodmult. 

tst_edebug 

vpti_state_dmatrixO 

Returns  the  value  of  Gvpt_dmatrix. 

concat.mtx,  mtx_non_perspective, 
nitx_perspective, 
old_nitx_perspective, 
vpt_path_update,  tst_edebug 

vpti_state_dpathO 

Returns  the  value  of  Gvpt_dpaih. 

vpt_path_process,  vpt_path_query, 
vpt_path_setup,  vpt_path_up^te, 
tst_edebug 

vpti_state_dtprocO 

Returns  the  value  of  Gvpt_dtproc. 

cig_config,  filLtxee,  tsi_edebug 

vpti_state_dtree_shortO 

Returns  the  value  of 
Gvpt_dtree_shorL 

tst_edebug,  pr_branch,  pr_matrix 

vpti_state_dvptnodeO 

Returns  the  value  of 

Gvpt_dvptnode. 

vpt_vpt_process,  vpt_vpt_set, 
tst_edebug,  p_viewport_state 

vpti_state_ed4x:0 

Returns  the  value  of  Gvpt_edtpc. 

cig_conflg,  tst_edebug 

vpti_state_efilltO 

Returns  the  value  of  GviK_efillL 

cig_config,  tst_edebug 

vpti_state_panel_alignO 

Returns  the  value  of 
Gvpt_paneLalign. 

vpt_path_iTOcess,  vpt_path_update, 
tst_edebug 

vpti_togstate_dcnodeO 

Toggles  the  state  of  Gvpt_dcnode. 

tst_edebug 

vpti_togstate_dlodmultO 

Toggles  the  state  of  Gvpt_dlodmult. 

tst_edebug 

vpti_togstate_dmatrixO 

Toggles  the  state  of  Gvpt_dmatrix. 

tst_edebug 

vpti_togstate_dpathO 

Toggles  the  state  of  Gvpt_dpath. 

tst_edebug 

vpti_togstate_dtprocO 

Toggles  the  state  of  Gvpt_dtproc. 

tst_edebug 

vpti_togstate_dtree_shortO 

Toggles  the  stale  of 
Gvpt_dtiiee_shcMt. 

tst_edebug 
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vpti_togstate_dvptnodeO 

Toggles  the  state  of  Gvpt_dvptnode. 

tst.edebug 

vpti_tQgstate_ed5)cO 

Toggles  the  state  of  Gvpt_edtpc. 

tst_edebug 

vpti_logstate_cfilltO 

Toggles  the  state  of  Gvpt_cfillt. 

tst_edebug 

vpti_togstate _panel_alignO 

Toggles  the  state  of 
Gvpt_panel_align. 

tst_edebug 

vpti_val_path_entry_indexO 

Returns  the  value  of 
Gvpt_path_cntry_index. 

vpt_path _get 

vpti_val_vpt_entry_indexO 

Returns  the  value  of 
Gvpt_vpt_entry_index. 

vpt_vpt_get 

Called  By:  see  above  table 

Routines  Called:  none 


Parameters:  see  above  table 


Returns: 


see  above  table 


2.17.9  init_free.c 

The  functions  in  the  init_free.c  CSU  are  used  to  initialize  and  remove  the  viewport 
configuration  tree.  These  functions  are: 

•  vpt_root_init 

•  vpt_tree_init 

•  vpt_tree_free 


2.17.9.1  vpt_root_init 

The  vpt_root_init  function  allocates  memoiy  for  the  view  positions  and  view  flags/branch 
value  arrays.  It  also  sets  pointers  in  the  root  node  to  these  arrays.  This  function  is  called 
by  vpt_cnode_process  when  adding  the  root  node  (node_index  =  0)  to  the  configuration 
tree. 

The  function  call  is  vpt_root_init().  vpt_root_init  does  the  following: 

•  Gets  the  pointer  to  the  root  node. 

•  Stores  a  pointer  to  the  view  positions  array  in  the  root  node's  first  child  pointer 
(which  is  otherwise  unused). 

•  Allocates  memory  for  the  view  positions  array  in  the  dynamic  section  of  active  area 
memory. 

•  Stores  a  pointer  to  the  branch  value  array  in  the  root  node's  branch_value  pointer. 

•  Allocates  memory  for  the  branch  value  array  in  the  dynamic  section  of  active  area 
memory. 
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The  function  returns  SUCCEED  if  the  structures  are  allocated  successfully.  It  returns 
FAIL  if  it  could  not  get  a  pointer  to  the  root  node  or  allocate  memory  for  one  of  the  airays. 


Called  By:  vpt_cnode_process 


Routines  Called:  aam_malloc 

printf 

vpti_get_ptr_cnode 


Parameters:  none 

Returns:  1  (SUCCEED) 

0  (FAIL) 


2.17.9.2  vpt_tree_init 

The  vpt_tree_init  function  initializes  all  viewport  configuration  static  variables  and  static 
pointer  lists.  This  function  is  called  at  system  initialization  time  and  when  the  Simulation 
Host  sends  a  CIG  Control-Stop  message  to  stop  the  simulation.  It  can  also  be  invoked 
through  Gossip  by  selecting  the  8  ("configtree  init")  option  from  the  Gossip  main  menu,  or 
the  I  ("Tree  Initialize")  option  from  the  Viewport  Test  menu. 

The  function  call  is  vpt_treejnit().  vpt_tree_init  does  the  following: 

•  Sets  the  following  global  variables  to  FALSE: 

-  Gvpt_dmatrix 

-  Gvpt_dvpmode 

-  Gvpt_dpath 

-  Gvpt_dlodmult 

-  Gvpt_dcnode 

-  Gvpt_dtproc 

-  Gvpt_efiilt 

-  Gvpt_edtpc 

•  Sets  the  following  global  variables  to  TRUE: 

-  Gvpt_dtree_short 

-  Gvpt_panel_align 

•  Initializes  the  viewport  parameters  entry  index  and  the  graphics  path  parameters 
entry  index  to  0. 

•  Sets  the  pointer  to  every  configuration  node  to  0. 

•  Sets  the  pointer  to  every  viewport  parameter  entry  to  0 

•  Sets  the  pointer  to  every  graphics  path  entry  to  0. 


Called  By: 


gossip_tick 

initialize 

ntsg_cig_ctl 

tst_tree 
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Routines  Called:  vpti_change_path_entry_index 

vpti_change_vpt_entry_index 
vpti_set_ptr_cnode 
vpti_set_ptr_path 
vpti_set_ptr_vpt 
vpti_set_state_dcnode 
vpti_set_state_dlodmult 
vpti_set_state_dinatrix 
vpti_set_state_dpath 
vpti_set_state_dtproc 
vpti_set_state_dtree_short 
vpti_set_state_dvptnode 
vpti_set_state_ed^c 
vpti_set_state_efillt 
vpti_set_state_panel_align 


Parameters:  none 

Returns:  none 


2.17.9.3  vpt_tree_free 

The  vpt_tree_free  function  firees  the  memory  allocated  for  all  configuration  nodes,  viewport 
parameters,  and  graphics  path  parameters.  This  function  is  called  when  the  Simulation 
Host  sends  a  CIG  Control-Stop  message  to  stop  the  simulation.  It  is  also  called  through 
Gossip  if  the  user  selects  the  F  ("Tree  Free")  option  from  the  Viewport  Test  menu. 

The  function  call  is  vpt_tree_free().  vpt_tree_free  does  the  following: 

•  For  each  configuration  node: 

-  Gets  the  pointer  to  the  node. 

-  If  the  root  node,  frees  the  view  flags/branch  value  and  view  positions 
arrays. 

Frees  the  allocated  DTP  matrix  area. 

-  Frees  the  memory  allocated  for  the  node. 

-  Sets  the  node's  pointer  to  0. 

•  For  each  viewport  parameter  entry: 

-  Gets  the  pointer  to  the  entry. 

-  Frees  the  viewing  range,  near  plane,  and  lod  multiplier. 

-  Frees  the  memory  allocated  for  the  entry. 

-  Sets  the  entry's  pointer  to  0. 

•  For  each  graphics  path  parameter  entry: 

-  Gets  the  pointer  to  the  entry. 

-  Frees  the  field-of-view  vectors,  perspective  matrix,  non-perspective  matrix, 
and  resolution. 

-  Gets  the  pointer  to  the  path. 

-  Frees  the  memory  allocated  for  the  path. 

-  Sets  the  entry's  pointer  to  0. 


Called  By:  msg_cig_ctl 
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tst_tree 

Routines  Called: 

aam_free 

free 

vpti_get_ptr_cnode 

vpti_get_ptr_path 

vpti_get_ptr_vpt 

vpti_set_ptr_cnode 

vpti_set_ptr_path 

vpti_setj)tr_vpt 

Parameters: 

none 

Returns: 

none 

2.17.10  linkvpt.c  (vpt_cnode_Iinkvpt) 

The  vpt_cnode_linkvpt  function  is  responsible  for  setting  a  viewport  node's  pointer  to  the 
correct  index  in  the  view  positions  array.  This  array  contains  one  entry  for  each  simulation 
vehicle  (currently  only  one).  The  array  is  pointed  to  by  the  root  configuration  node. 

The  function  call  is  vpt_cnode_Unkvpt(vpt_node,  ptr_vppos,  index),  where: 

vpt  node  is  a  pointer  to  the  viewport  parameters  node 
ptr  vppos  is  a  pointer  to  the  view  positions  array 
index  is  the  configuration  node's  index 

vpt_cnode_linkvpt  does  the  following: 

•  Calls  vpti_get_ptr_cnode  to  get  the  pointer  to  the  view  positions  array  (stored  in  the 
root  node's  first  child  pointer  slot). 

•  Calls  vpti_get_ptr_cnode  to  get  a  pointer  to  the  specified  configuration  node. 

•  Sets  the  node's  viewport  parameters  pointer  to  the  specified  viewport  node. 

•  Matches  the  viewport  with  a  hull/world  (simulation  vehicle)  transformation  matrix, 
by  finding  the  veh  de  id  in  the  view  positions  array.  Currently,  only  one 
simulation  vehicle  is  supported,  so  there  is  only  one  element  in  the  array. 

The  status  returned  by  the  function  is  1  (SUCCEED)  if  it  is  successful,  or  0  (FAIL)  if  the 
configuration  node  pointer  is  NULL  or  the  node  index  is  invalid. 


Called  By:  vpt_vpt_process 


Routines  Called:  vpti_get_ptr_cnode 


Parameters:  VIEWPORT-PARAMETERS  *vpt_node 

R4P3D  **ptr_vppos 

INT_2  index 
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Returns:  status 


2.17.11  intx_concat.c  (concat_mtx) 

The  concat_mtx  function  creates  or  updates  the  DTP  matrix  for  a  specified  configuration 
node,  and  places  the  matrix  into  active  area  memory.  This  function  is  called  to  generate  and 
load  the  initial  matrix  for  each  matrix  node  during  viewport  configuration.  It  is  also  called 
to  update  dynamic  matrices  during  the  simulation  if  the  Simulation  Hosts  sends  any  of  the 
following  messages:  MSG_ROT2xl_MATRlX,  MSG_RTS4x3_MATRIX, 
MSG_HPRXYZS_MATRIX,  MSG_TRANSLATION,  MSG_SCALE. 
MSG_lROTATION,  or  MSG_3ROTATIONS. 

The  function  call  is  concat_mtx(config_node,  pmtx),  where: 

configjiode  is  a  pointer  to  the  configuration  node 
pmtx  is  the  node's  new  matrix 

concat_mtx  does  the  following: 

•  Verifies  that  the  DTP  matrix  address  is  valid. 

•  If  the  matrix  is  defined  as  dynamic,  finds  the  offset  to  the  current  double  buffer  and 
finds  the  location  in  active  area  memory  for  the  matrix. 

•  Unpacks  the  matrix  sent  from  the  Simulation  Host. 

•  For  an  RTS4x3  matrix: 

-  Calls  mtxcpy  to  copy  the  new  matrix  to  A  AM. 

•  For  an  ROT2xl  matrix: 

-  Determines  which  axis  the  matrix  is  to  be  rotated  along. 

Updates  the  matrix's  rotation  values  in  AAM. 

•  For  an  RTS 3x3  (HPRXYZS)  matrix: 

Calls  make4x3  to  create  the  matrix,  performing  the  concatenations  in  the 
order  specified  in  the  message. 

•  If  this  is  a  dynamic  matrix  node,  calls  mtxcpy  to  copy  the  matrix  to  the 
configuration  node's  entry  for  use  in  terrain  feedback  processing. 

If  successful,  the  function  returns  err  code  set  to  1  (TRUE).  If  an  invalid  DTP  matrix 
address  is  detected,  the  function  returns  no  value. 


Called  By:  vpt_cnode_set_matrix 

vpt_update_mtx 

vpt_update_rot 


Routines  Called:  be_query_buffer_offset 

cos 

make4x3 

mtxcpy 

printf  (in  debug  mode  only) 

r4mat_dump  (in  debug  mode  only) 

sin 

TORAD 
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vpti_state_dniatrix  (in  debug  mode  only) 

Parameters:  CONFIGURATION_NODE  *config_node 

MTXUNION  *pmtx 

Returns:  err_code 


2.17.12  intx_dump.c 

The  functions  in  the  mtx_dump.c  CSU  can  be  used  to  dump  a  matrix  to  stdout.  These 
functions  are: 

•  r4mat_dump 

•  r8mat_dump 


2.17.12.1  r4mat_dump 

The  r4mat_dump  function  dumps  a  matrix  to  stdout.  This  function  is  called  only  by  test 
routines  or  if  debug  mode  is  enabled. 

The  function  call  is  r4mat_dump(str,  mat),  where: 

str  is  a  string  to  display  (on  stdout)  to  describe  the  matrix 

mat  is  a  pointer  to  the  location  in  active  area  memory  that  contains  the  matrix 

r4mat_dump  first  calls  bus_error  to  verify  that  the  matrix  address  is  valid.  It  then  outputs 
the  matrix  to  stdout. 


Called  By: 

concat_mtx 

(in  debug  mode  only) 

p_configtree_node 

pr_matrix 

(in  debug  mode  only) 

vpt_cnode_set_matrix 

(in  debug  mode  only) 

vpt_path_update 

vptq_cnout 

vptq_dynmtx 

vptq_gjx)ut 

(in  debug  mode  only) 

Routines  Called: 

bus_eiTor 

printf 

Parameters: 

char 

*str 

REAL_4 

mat[4][3] 

Returns: 

none 
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2.17.12.2  r8mat_dunip 

The  r8mat_dump  function  dumps  a  matrix  to  stdout. 

The  function  call  is  r8mat_dump(str,  mat),  where: 

str  is  a  string  to  display  (on  stdout)  to  describe  the  matrix 

mat  is  a  pointer  to  the  location  in  active  area  memory  that  contains  the  matrix 

r8mat_dump  first  calls  bus_error  to  verify  that  the  matrix  address  is  valid.  It  then  outputs 
the  matrix  to  stdout 

This  function  is  not  currently  used. 


Called  By: 

none 

Routines  Called: 

bus_error 

printf 

Parameters: 

char 

*str 

REAL_8 

mat[4][3] 

Returns: 

none 

2.17.13  mtx_viewspace.c 

The  functions  in  the  mtx_viewspace.c  CSU  generate  perspective  view  matrices  for  use  by 
the  Polygon  Processor,  and  non-perspective  view  matrices  for  use  by  DTP.  These 
functions  are: 

•  mtx_non_perspective 

•  mtx_perspective 

•  old_mtx_perspective 


2.17.13.1  mtx_non_perspective 

The  mtx_non_perspective  function  produces  a  view  matrix  without  perspective  for  use  by 
the  Poly  Processor.  This  function  is  called  when  graphics  path  parameters  are  updated. 

The  function  call  is  mtx_non_perspective(cos_i,  sin_i,  matrix),  where: 

cos  i  is  the  cosine  of  the  graphics  path 
sin  j  is  the  sine  of  the  graphics  pa^ 
matrix  is  the  destination  matrix 
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Called  By:  vpt_path_update 


Routines  Called: 


printf  (in  debug  mode  only) 

vpti_state_dmatrix  (in  debug  mode  only) 


Parameters:  REAL_4  cos_i 

REAL_4  sin_i 

T_MATRIX  matrix 


Returns:  none 


2.17.13.2  intx_perspective 

The  mtx_perspective  function  produces  a  view  matrix  with  perspective  for  use  by  DTP. 
When  graphics  path  parameters  are  updated,  this  function  is  called  (instead  of 
old_mtx_perspective)  if  the  Gvpt^anel_align  variable  is  TRUE. 

The  function  call  is  mtx_perspective(thx,  thy,  I,  J,  zn,  panein,  paneli,  scale, 
matrix),  where:  ” 

thx  is  the  tangent  of  one-half  the  horizontal  channel  field  of  view  divided  by  the  number 
of  panels 

thy  is  the  tangent  of  one-half  the  vertical  channel  field  of  view 

I  is  the  number  of  horizontal  pixels  in  the  panel 

J  is  the  number  of  vertical  pixels  in  the  panel 

zn  is  the  distance  to  the  near  plane 

panein  is  the  number  of  panels 

paneli  is  the  panel  number  (leftmost  is  0) 

scale  is  the  scale  factor  used  to  scale  matrices  if  load  module  blocking  is  enabled 
matrix  is  the  destination  matrix 


Called  By: 

vpt_path_update 

Routines  Called: 

printf 

(in  debug  mode  only) 

vpti_state_dmatrix 

(in  debug  mode  only) 

Parameters: 

float 

thx 

float 

thy 

int 

I 

int 

J 

float 

zn 

int 

panein 

int 

paneli 

float 

scale 

REAL_4 

matrixf4][3] 
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Returns:  none 


2.17.13.3  oId_intx_perspective 

The  old_nitx_perspective  function  produces  a  view  matrix  with  perspective  for  use  by 
DTP.  When  graphics  path  parameters  arc  updated,  this  function  is  called  (instead  of 
mtx_perspective)  if  the  Gvpt_panel_align  variable  is  FALSE. 

The  function  call  is  old_intx_perspective(itan_i,  itan_j,  off_x,  off_y,  cos_i, 
sin_i,  sc,  matrix),  where: 

itan  i  is  the  inverse  of  the  tangent  of  the  field-of-view  angle  i  (horizontal) 

itan J  is  the  inverse  of  the  tangent  of  the  field-of-view  angle)  (vertical) 

offjc  is  the  horizontal  offset 

off_y  is  the  vertical  offset 

cos  i  is  the  cosine  of  the  graphics  path 

sin  i  is  the  sine  of  the  graphics  pa^ 

sc  is  the  scale  factor  used  to  scale  matrices  if  load  module  blocking  is  enabled 
matrix  is  the  destination  matrix 


CaUedBy: 

vpt_path_update 

Routines  Called: 

printf 

(in  debug  mode  only) 

vpti_state_dmatrix 

(in  debug  mode  only) 

Parameters: 

REAL  4 

itanj 

REAL  4 

itanj 

REAL  4 

off_x 

REAL  4 

off_y 

REAL  4 

cos_i 

REAL  4 

sin_i 

REAL  4 

sc 

T_MATRIX 

matrix 

Returns: 

none 

2.17.14  path.c 

The  functions  in  the  path.c  CSU  set  and  update  graphics  path  parameters.  These  functions 
arc: 


vpt_path_process 

vpt_path_update 
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2.17.14.1  vpt_path_process 

The  vpt_pathj)rocess  function  initializes  the  fov-related  fields  in  the  graphics  path 
parameters  and  the  viewport  parameter  entries.  This  function  is  called  when  a  node  with 
viewport  parameters  is  first  defined  and  when  it  is  updated. 

The  function  call  is  vpt_path_process  (graphics_path,  num_of_paths_i, 
num_of_paths_j,  vptjfez,  vpt_fov,  offset),  where: 

graphics _pctth  is  a  pointer  to  the  graphics  path  parameters 
nwn  of  j)aths_i  is  the  number  of  paths  in  the  i  direction 
num  of  j}aths  J  is  the  number  of  paths  in  the  j  direction 
vpt  rez  is  the  viewport's  resolution 
vptjov  is  the  viewport's  field  of  view 
offset  is  the  offset  to  the  current  double  buffer 

vpt_path_process  processes  each  graphics  path  in  turn.  For  each  path,  it  does  the 
following: 

•  Divides  the  field  of  view  and  resolution  by  the  number  of  paths. 

•  Calculates  and  sets  the  path's  field-of-view  vectors. 

•  If  panel  alignment  is  enabled,  sets  the  path's  panel  align  value. 

•  Sets  the  path's  resolution. 

•  Calculates  the  path's  center. 

•  Calls  vpt4)ath_update  to  set  the  dynamic  values  in  each  path. 

The  function  returns  SUCCEED  if  it  is  successful.  It  returns  FAIL  if  vpt_path_update 
could  not  update  the  path  parameters. 


Called  By: 


vpt_update 


Routines  Called:  printf  (in  debug  mode  only) 

tan 

TORAD 

vpt_path_update 

vpti_state_dpath  (in  debug  mode  only) 

vpti_state_panel_align 


Parameters: 


GRAPHICS_PATH_PARAMETERS 

INT_2 

INT_2 

I4IJ 

R4IJ 

UNS_4 


♦graphic  s_path 

num_of_paths_i 

num_of_pathsJ 

vpt_rez 

vpt_fov 

offset 


Returns: 


1  (SUCCEED) 
0  (FAIL) 
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2.17.14.2  vpt_path_update 

The  vpt_path_update  function  updates  a  graphics  path’s  matrices,  field-of-view  vectors, 
and  screen  constants  for  DTP.  This  function  is  called  after  the  path  parameters  are 
initialized. 

The  function  call  is  vpt_path_update(graphics_path,  offset),  where: 

graphics _path  is  a  pointer  to  the  graphics  path 
offset  is  the  offset  to  the  current  double  buffer 

vpt_path_update  does  the  following: 

•  Verifies  that  all  of  the  graphics  path  parameters  are  present 

•  Calculates  the  inverse  of  Ae  tangent  of  the  fov  angles. 

•  Calculates  the  cosine  and  sine  of  the  graphics  path  center. 

•  Calls  mtx_non_perspective  to  build  a  non-perspective  view  matrix  for  DTP. 

•  Sets  the  DTP  commands  for  processing  of  the  perspective  matrix. 

•  Calls  mtx_perspective  (if  panel  alignment  is  enabled)  or  old_mtx_perspective  (if 
panel  alignment  is  not  enabled)  to  build  a  perspective  view  matrix  for  ^e  Poly 
Processor. 

•  Sets  the  path's  field-of-view  vectors. 

•  Sets  the  path's  screen  resolution  constants. 

The  function  returns  SUCCEED  if  the  graphics  path  is  updated  successfully.  It  returns 
FAIL  if  any  of  the  graphics  path's  pointers  are  MILL. 


Called  By:  vpt_path_process 

vpt_update_one_path 


Routines  Called:  atan 

cos 

mtx_non_perspective 

mtx_perspective 

old_moc_perspective 

printf 

r4mat_dump  (in  debug  mode  only) 

sin 

tan 

TO^ 

vpti_state_dmatrix  (in  debug  mode  only) 

vpti_state_dpath  (in  debug  mode  only) 

vpti_state_panel_align 


Parameters: 


GRAPHICS_PATH_PARAMETERS  *graphics_path 

UNS_4  offset 


Returns:  1  (SUCCEED) 
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0(FAIL) 


2.17.15  path_init.c 

The  functions  in  the  path_init.c  CSU  allocate,  initialize,  and  set  up  graphics  path  data  for 
configuration  nodes  that  have  viewport  parameters.  These  functions  are: 

•  vpt_path_get 

•  vpt_path_init 

•  vpt_path_setup 


2.17.15.1  vpt_path_get 

The  vpt_path_get  function  allocates  memory  for  the  graphics  path  parameters  node  and  sets 
the  pointers  in  the  path  pointer  table.  This  function  is  called  whenever  a  new  viewport 
parameters  node  is  defined. 

The  function  call  is  vpt_path_get(num_paths),  where  num _paths  is  the  number  of 
graphics  paths  requir^.  ~ 

vpt_path_get  does  the  following: 

•  Verifies  that  the  array  will  hold  another  pointer. 

•  Allocates  memory  for  the  number  of  graphics  paths  specified. 

•  Verifies  that  the  memory  was  allocated. 

•  Adds  the  entry  to  the  Gvpt_path_pointers[]  table. 

•  Increments  the  path  entry  index. 

•  Sets  up  the  graphics  path  sibling  pointers  (each  points  to  the  next  path). 

If  successful,  the  functions  returns  a  pointer  to  the  first  graphics  path  structure  as  gp. 


Called  By:  vpt_path_setup 


Routines  Called:  calloc 

printf 

vpti_increment_path_entry_index 

vpti_set_ptr_path 

vpti_val_path_entry_index 


Parameters:  INT_2  num_paths 


Returns:  gp 
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2.17.15.2  vpt_path_init 

The  vpt_path_init  function  allocates  DTP  memory  for  the  perspective  matrix,  non¬ 
perspective  matrix,  field-of-view  vectors,  and  screen  constants.  This  function  is  called 
whenever  a  new  viewport  parameters  node  is  defined. 

The  function  call  is  vpt_path_init(graphics_path),  where  graphics _path  is  a  pointer  to 
the  graphics  path  parameters. 

vpt_path_init  does  the  following: 

•  Allocates  memory  for  the  perspective  matrix. 

•  Allocates  memory  for  the  non-perspective  matrix. 

•  Allocates  memory  for  the  field-of-view  vectors. 

•  Allocates  memory  for  the  resolution. 

•  Verifies  that  memory  was  allocated  for  all  of  the  structures. 


Called  By:  vpt_path_setup 


Routines  Called:  aam_malloc 

printf 


Parameters:  GRAPHICS_PATH_PARAMETERS  *graphics_path 

Returns:  none 


2.17.15.3  vpt_path_setup 

The  vpt_path_setup  function  allocates  and  initializes  graphics  path  nodes,  sets  pointers  to 
the  viewport  node,  and  sets  the  path  id  and  sibling  pointers.  This  function  is  called 
whenever  a  node  with  viewport  parameters  is  added  to  the  configuration  tree. 

The  function  call  is  vpt_path_setup(viewport,  vpt  path  param  ptr, 
num_of_paths_i,  num_of_paths _j,  start_path_id),  wRere: 

viewport  is  a  pointer  to  the  viewport  parameters 
vpt _path  jparam _ptr  is  a  pointer  to  the  graphics  path  parameters 
num  of  paths _i  is  the  number  of  paths  in  the  i  direction 
num_ofj)aths  J  is  the  number  of  paths  in  the  j  direction 
start jjathJd  is  the  number  of  the  first  path  in  the  structure;  this  varies  by  type  of 
backend 

For  each  graphics  path  entry  in  the  structure,  %T3t_path_setup  does  the  following; 

•  Calls  vpt_path_get  to  allocate  memory  for  the  graphics  paths  and  get  a  pointer  to  the 
first  path  structure  in  the  group. 

•  Sets  the  viewport  pointer  to  point  to  the  first  path. 
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•  Calls  vpt_path_init  to  allocate  memory  for  the  matrices,  fov  vectors,  etc. 

•  Sets  the  graphics  path  pointer  to  point  to  the  vie^ort 

•  Sets  the  graphics  path's  path  id  to  the  start  path  id. 

The  function  always  returns  SUCCEED. 


Called  By: 


vpt_vpt_set 


Routines  Called:  printf 

vptj)ath_get 

vpt^ath_init 

vpti_state_dpath 


(in  debug  mode  only) 


(in  debug  mode  only) 


Parameters: 


VIEWPORT_PARAMETERS  *viewport 
GRAPH1CS_PATH_PARAMETERS 


INT_2 

INT_2 

INT_2 


*  *  vpt_path_param_ptr 
num_of_paths_i 
num_of_paths_j 
start_path_id 


Returns:  1  (SUCCEED) 


2.17.16  path_query.c  (vpt_path_query) 

The  vpt_path_query  function  copies  graphics  path  node  information  (path  id,  field-of-view 
vectors,  resolution,  screen  constants,  etc.)  to  a  query  structure.  This  function  is  used  in 
testing  only. 

The  function  call  is  vpt_path_query(gp,  pi),  where: 

gp  is  a  {Winter  to  the  graphics  path  parameters 
pi  is  a  pointer  to  the  query  structure 

vpt_path_query  zeroes  out  the  query  structure  before  copying  the  data  to  it. 


Called  By:  vptq_grout 


Routines  Called:  printf 

vpti_state_dpath 


(in  debug  mode  only) 
(in  debug  mode  only) 


Parameters: 


GRAPfflCS_PATH_PARAMETERS  *gp 

VPT_PATH_INFO  *pi 


Returns:  none 
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2.17.17  trav_tree.c 

The  trav_tree  function  traverses  up  each  viewport  node  and  sets  up  a  branch  array  for  each 
viewport  TTiis  array  can  be  used  to  determine  which  viewports  are  active  at  any  given 
time. 

The  function  call  is  trav  tree(). 


Called  By:  cig_config 

tst_equery 


Routines  Called;  printf 

vpti_get_ptr_vpt 


Parameters:  none 


Returns:  none 


2.17.18  tst_edebug.c 

The  tst_edebug  function  reports  the  state  of  all  Viewport  Configuration  debug  flags  and  lets 
the  Gossip  user  toggle  them.  This  function  is  called  if  the  user  selects  the  1  ("Change 
debug  switches")  option  from  the  Viewport  Test  menu. 

The  function  call  is  tst_edebug().  tst_edebug  displays  the  Current  Debug  Switches  menu 
showing  the  current  state  of  each  debug  flag.  (The  function  calls  the  vpti_state_*  functions 
to  determine  the  current  states.)  The  user  can  select  an  option  from  the  menu  to  toggle  the 
state  of  the  corresponding  flag. 

The  following  table  identifies  the  options  on  the  Current  Debug  Switches  menu  and  shows 
the  steps  performed  by  tst_edebug  in  response  to  each  selection.  For  definitions  of  the 
variables  referenced  here,  see  globs.c. 
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Current  Debug  Switches  Menu 
Option 

Processing  by  tst_edebug 

1  Debug  Matrix 

Calls  vpti_togstate_dmatrix  to  toggle  Gvpt_dmatrix. 

2  Debug  Viewport  Node 

Calls  vpti_togstate_dvptnode  to  toggle  Gvpt_dvptnode. 

3  Debug  Path 

Calls  vpti_togstate_dpath  to  toggle  Gvpt_dpath. 

4  Debug  Config  Node 

Calls  vpti_togstate_dcnode  to  toggle  Gvpt_dcnode. 

5  Debug  LOD 

Calls  vpti_togstate_dlodmult  to  toggle  Gvpt_dlodmulL 

6  Short  tree  debug 

Calls  vpti_togstate_dtree_short  to  toggle 
Gvpt_dtree_shorL 

7  Tree  proc  debug 

Calls  vpti_togstate_dtproc  to  toggle  Gvpt_dtproc. 

8  Exit  at  fill  tree 

Calls  vpti_togstate_efillt  to  toggle  Gvpt_efillt. 

9  Exit  at  dtp  comp 

Calls  vpti_togstate_edtpc  to  toggle  Gvpt_edtpc. 

a  Panel  alignment 

Calls  vpti_togstate_panel_align  to  toggle 
Gvpt_panel_align. 

X  Exit  this  menu 

Exits. 

Called  By:  tst_tree 


Routines  Called:  printf 

scanf 

vpti_state_dcnode 

vpti_state_dlodmuIt 

vpti_state_dmatrix 

vpti_state_dpath 

vpti_state_dtproc 

vpti_state_dtree_short 

vpti_state_dvptnode 

vpti_state_ed^c 

vpti_state_efillt 

vpti_state_panel_align 

vpti_togstate_dcnode 

vpti_togstate_dlodmult 

vpti_togstate_dmatrix 

vpti_togstate_dpath 

vpti_togstate_dtproc 

vpti_togstate_dtree_short 

vpti_togstate_dvptnode 

vpti_togstate_edtpc 

vpu_togstate_efillt 

vpti_togstate_panel_align 


Parameters:  none 


Returns:  none 
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2.17.19  tst_equery.c 

The  functions  in  the  tst_equery.c  CSU  let  the  Gossip  user  query  (view)  the  data  in  any 
configuration  node,  viewport  parameters,  or  graphics  path  parameters  structure.  These 
functions  are: 

•  tst_equery 

•  vptq_grptrs 

•  vptq_''pptrs 

•  vptq_cnptrs 

•  vptq_lHvals 

•  vptq_activept 

•  vptq_vptbrDut 

•  vptq_dynmtx 

•  vptq_cnout 

•  vptq_vpout 

•  vptq_grout 

The  tst_equery  function  presents  a  menu  from  which  the  user  selects  the  type  of  data  to 
view.  Each  vptq_*  function  displays  a  specific  type  of  data. 


2.17.19.1  tst_equery 

The  tst_equery  function  presents  a  menu  to  the  Gossip  user  to  allow  viewing  of 
configuration  tree  node  data,  viewport  parameters,  and  graphics  path  parameters.  This 
function  is  called  if  the  user  selects  the  2  ("Query  mode")  option  from  the  Viewport  Test 
menu. 

The  function  call  is  tst_equery.  The  following  table  identifies  the  options  supported  by 
tst_equery,  and  shows  the  steps  performed  by  tst_equery  for  each  user  selection. 
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1  Query  Mode  Menu  Option 

Processing  by  tst_equi;ry 

Display  options 

Displays  this  menu. 

1 

Show  conOgnode  pointers  table 

Calls  vptq_cnptrs. 

2 

Show  viewport  pointers  table 

Calls  vptq_vpptrs. 

3 

Show  gr^hics  path  pointers  table 

Calls  vntq  grptrs. 

4 

Query  confignode  given  table  offset 

Calls  vptq_cnout. 

5 

Query  viewport  given  table  offset 

Calls  vptq_vpout 

6 

Query  graphics  path  given  table  offset 

Calls  vptq_grout. 

7 

Show  branch  node  info 

Calls  vptq_brvais. 

8 

Show  matrix  node  info 

Calls  vptq_dynmtx. 

9 

Show  viewport  branch  mask  info 

Calls  vptq_vptbrout. 

A 

Compute  active  viewports 

Calls  vptq_activevpt 

B 

Call  trav  tree 

Calls  trav_tree. 

X 

Exit  this  menu 

Exits. 

Called  By:  tst_tree 


Routines  Called: 


printf 

scanf 

trav_tree 

vptq_activevpt 

vptq_brvals 

vptq_cnout 

vptq_cnptrs 

vptq_dynmtx 

vptq_grout 

vptq_grptrs 

vptq_vpout 

vptq_vpptrs 

vptq_vptbrout 


Parameters:  none 

Returns;  none 


2.17.19.2  vptq_grptrs 

The  vptq_grptrs  function  displays  the  graphics  path  pointers  for  each  node  with  viewport 
parameters.  This  function  is  called  if  the  Gossip  user  selects  the  3  ("Show  graphics  path 
pointers  table")  option  from  the  Query  Mode  menu. 

The  function  call  is  vptq_grptrs(). 
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Called  By:  tst_equery 

Routines  Called:  printf 

vpti_get_ptr_path 

Parameters:  none 

Returns:  none 

2.17.19.3  vptq_vpptrs 

The  vptq_vpptrs  function  displays  the  viewport  node  pointers  for  every  node  with  viewport 
parameters.  This  function  is  called  if  the  Gossip  user  selects  the  2  ("Show  viewport 
pointers  table")  option  from  the  Query  Mode  menu. 

The  function  call  is  vptq_vpptrs(). 

Called  By:  tst_equery 

Routines  Called:  printf 

vpti_get_ptr_vpt 

Parameters:  none 

Returns:  none 

2.17.19.4  vptq_cnptrs 

The  vptq_cnptrs  function  displays  the  configuration  node  pointers  for  all  nodes  in  the 
configuration  tree.  This  function  is  called  if  the  Gossip  user  selects  the  1  ("Show 
confignode  pointers  table")  option  from  the  Query  Mode  menu. 

The  function  call  is  vptq_cnptrs(). 

Called  By:  tst_equery 

Routines  Called:  printf 

vpti_get_ptr_cnode 

Parameters:  none 
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Returns; 


none 


2.17.19.5  vptq_brvals 

The  vptq_brvals  function  displays  information  on  all  branch  (conditional)  nodes  in  the 
configuration  tree.  The  displayed  shows  each  node's  node  index,  branch  mask,  branch 
index,  current  branch  value,  and  description.  This  function  is  called  if  the  Gossip  user 
selects  the  7  ("Show  branch  node  info")  option  from  the  Query  Mode  menu. 


The  function  call  is  vptq_brvals(). 


Called  By:  tst_equery 


Routines  Called:  printf 

scanf 

vpt_cnode_query 

vpti_get_ptr_cn^e 


Parameters: 


Returns: 


none 


none 


2.17.19.6  vptq_activept 


The  vptq_activept  function  determines  the  node  index  and  viewport  id  of  each  viewport  that 
is  currently  active,  using  the  array  created  by  trav_tree.  This  function  is  called  if  the 
Gossip  user  selects  the  A  ("Compute  active  viewports”)  option  from  the  (^uery  Mode 
menu. 


The  function  call  is  vptq_activept(). 


Called  By:  tst_equery 


Routines  Called:  be_query_buffer_offset 

printf  (in  debug  mode  only) 

vpt_cnode_qroot 

vpt _get_ptr_vpt 


Parameters:  none 

Returns:  none 
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2.17.19.7  vptq_vptbrout 

The  vptq_vptbrout  function  displays  branch  mask  information  for  each  viewport  node. 
The  display  shows  each  node's  viewport  id,  node  index,  and  branch  value  status.  This 
function  is  called  if  the  Gossip  user  selects  the  9  ("Show  viewport  branch  mask  info") 
option  from  the  Query  Mode  menu. 

The  function  call  is  vptq_vptbrout(). 


Called  By:  tst_equeiy 


Routines  Called: 


printf 

scanf 

vpti_get_ptr_vpt 


Parameters:  none 

Returns:  none 


2.17.19.8  vptq__dynmtx 

The  vptq_dynmtx  function  displays  matrix  information  for  every  configuration  node 
defin^  as  a  dynamic  (changeable)  matrix  node.  The  display  shows  each  node’s  matrix 
type,  description,  and  current  matrix.  This  function  is  called  if  the  Gossip  user  selects  the 
8  ("Show  matrix  node  info")  option  from  the  Query  Mode  menu. 

The  function  call  is  vptq_dynmtx(). 


Called  By:  tst_equery 


Routines  Called:  printf 

r4mat_dump 

scanf 

vpt_cnode_query 

vpti_get_ptr_cnode 


Parameters:  none 

Returns:  none 
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2.17.19.9  vptq_cnout 

The  vptq_cnout  function  displays  detailed  information  describing  a  specific  configuration 
node,  lihe  user  is  first  prompted  for  the  configuration  node  piointer.  The  display  includes 
the  node's  index,  parent  index,  matrix  type,  branch  index,  sibling  and  child  pointers, 
matrix,  etc.  This  function  is  called  if  the  Gossip  user  selects  the  4  ("Query  confignode 
given  table  offset")  option  from  the  Query  Mode  menu. 

The  function  call  is  vptq_cnout(). 


Called  By:  tst_equery 


Routines  Called:  printf 

r4mat_dump 

scanf 

vpt_cnode_query 

vpti_get_ptr_cnode 


Parameters:  none 

Returns:  none 


2.17.19.10  vptq_vpout 

The  vptq_vpout  function  displays  detailed  information  describing  a  specific  viewport  node. 
The  user  is  first  prompted  for  the  viewport  parameters  pointer.  The  display  includes  the 
node  index,  viewport  id,  field-of-view  parameters,  level-of-detail  parameters,  resolution, 
near  plane,  viewing  range,  etc.  This  function  is  called  if  the  Gossip  user  selects  the  5 
("Query  viewport  given  table  offset")  option  from  the  Query  Mode  menu. 

The  function  call  is  vptq_vpout(). 


Called  By:  tst_equery 


Routines  Called:  printf 

scanf 

vpt_vpt_query 

vpti_get_ptr_vpt 


Parameters:  none 

Returns:  none 
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2.17.19.11  vptq_grout 

The  vptq_grout  function  displays  detailed  information  describing  a  specific  graphics  path. 
The  user  is  first  prompted  for  the  graphics  path  pointer.  The  display  includes  the  path  id, 
viewport  id,  panel  alignment  setting,  field-of-view  angles,  screen  resolution,  vector  data, 
screen  constants,  etc.  If  the  node  has  a  sibling,  the  user  is  given  the  option  of  dumping  the 
sibling's  data  also.  This  function  is  called  if  the  Gossip  user  selects  the  6  ("Query  graphics 
path  given  table  offset")  option  from  the  Query  Mode  menu. 

The  function  call  is  vptq  groutQ. 


Called  By: 

tst_equery 

Routines  Called: 

printf 

r4mat_dump 

scanf 

vpt_path_query 

vpti_jet_ptr_path 

Parameters: 

none 

Returns: 

none 

2.17.20  tst_ereadconfig.c 

The  functions  in  the  tst_ereadconfig.c  CSU  support  building  a  configuration  tree  from  an 
ASCn  file  created  offline.  These  functions  accommodate  testing  the  viewport 
configuration  process  without  connection  to  a  Simulation  Host. 

The  functions  in  tst_ereadconfig  are: 

•  tst_ereadconfig 

•  p_configtree_node 

•  p_viewport_state 

•  p_overlay_setup 

•  setup_p_terTain_feedback 

•  p_terrain_feedback 

The  messages  (commands)  that  can  be  included  in  the  ASCII  configuration  file  are  defined 
in  the  vpi_msgs.h  file.  These  are  not  the  same  messages  as  those  used  by  the  Simulation 
Host  to  define  a  viewport  configuration  tree. 
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2.17.20.1  tst_ereadconfig 

The  tst_ereadconfig  function  reads  and  processes  an  ASCII  viewpon  configuration  file 
created  offline.  This  function  is  called  if  the  Gossip  user  selects  the  "Read  configuration 
file  and  process"  option  from  the  Viewport  Test  menu. 

The  function  call  is  tst_ereadconfig().  tst_ereadconfig  does  the  following: 

•  Prompts  the  user  to  enter  the  name  of  the  configuration  file  to  be  processed. 

•  Opens  the  specified  file. 

•  Reads  a  line  from  the  file  into  a  command  buffer. 

•  Processes  the  message  in  the  command  buffer  as  follows: 

START_CONFIGTREE_NODE  -  Calls  p_configtree_node. 
START_VIEWPORT_STATE  -  Calls  p_viewport_state. 
START_OVERLAY_SETUP  -  CaUs  p_overlay_setup. 
START_TERRAIN_FEEDBACK  -  Calls  setup_p_terrain_feedback. 
START_TERRAIN_FEEDBACK_POINT_INrr  -  Calls  p_terrain_feedback. 

•  When  an  END  message  is  detected,  closes  the  file. 

The  function  exits  with  a  1  if  the  specified  file  cannot  be  opened. 


Called  By:  tst_tree 


Routines  Called:  exit 

fclose 

fopen 

fscanf 

p_configtree_node 

p_overlay_setup 

p_terrain_feedback 

p_viewport_state 

printf 

scanf 

setup_p_terrain_feedback 

strcmp 


Parameters:  none 

Returns;  none 


2.17.20.2  p_configtree_node 

The  p_configtree_node  function  handles  the  creation  of  all  configuration  nodes  specified  in 
the  ASCII  viewport  configuration  file.  It  builds  a  Simulation  Host-type  message,  then  calls 
the  appropriate  vpt_  function  to  create  the  configuration  node.  This  function  is  called  if  the 
file  specifies  START_CONnGTREE_NODE. 
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The  function  call  is  p_configtree_node().  p_configtree_node  does  the  following: 

•  Initializes  the  MSG_CREATE_CONFIGNODE  message. 

•  Reads  each  parameter  in  turn  from  the  file  into  the  command  buffer. 

•  Determines  the  parameter  from  the  command  buffer,  then  reads  the  corresponding 
value  from  the  ^e  to  build  the  message. 

•  Stops  reading  the  file  when  it  detects  an  END_CONFIGTREE_NODE  command. 

•  Calls  vpt_cnode_process  to  create  the  node. 


Called  By: 

tst_ereadconfig 

Routines  Called: 

fgetc 

fscanf 

printf 

r4mat_dump 

strcmp 

vpt_cnode_process 

vpti_state_dcnode 

(in  debug  mode  only) 

(in  debug  mode  only) 

Parameters: 

none 

Returns: 

none 

2.17.20.3  p_viewport_state 

The  p_viewport_state  function  handles  the  creation  of  all  viewport  parameters  specified  in 
the  ASCII  viewport  confi^ration  file.  It  builds  a  Simulation  Host-type  message,  then  calls 
the  appropriate  vpt_  function  to  create  the  viewport  parameters.  This  function  is  called  if 
the  file  specifies  START_VIEWPORT_STATE. 

The  function  call  is  p_viewport_state().  p_viewport_state  does  the  following: 

•  Initializes  the  MSG_VIEWPORT_STATE  message. 

•  Reads  each  parameter  in  turn  from  the  file  into  the  command  buffer. 

•  Determines  the  parameter  from  the  command  buffer,  then  reads  the  corresponding 
value  from  the  file  to  build  the  message. 

•  Stops  reading  the  file  when  it  detects  an  END_VIEWPORT_STATE  command. 

•  Calls  vpt_vpt_process  to  create  the  viewport  parameters. 


Called  By:  tst_ereadconfig 


Routines  Called: 


fscanf 

printf 

strcmp 

vpt_vpt_process 

vpti_state_dvptnode  (in  debug  mode  only) 
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Parameters:  none 

Returns:  none 


2.17.20.4  p_overIay_setup 

The  p_overlay_setup  function  handles  the  creation  of  all  gun  barrel  and  gunner  overlays 
specified  in  the  ASCII  viewport  configuration  file  by  building  a  Simulation  Host-type 
message.  This  function  is  called  if  the  file  specifies  START_OVERLAY_SETUP. 

The  function  call  is  p__overIay_setup().  p_overlay_setup  does  the  following: 

•  Initializes  the  MSG_OVERLAY_SETUP  message. 

•  Reads  each  parameter  in  turn  from  the  file  into  the  command  buffer. 

•  Determines  the  parameter  from  the  command  buffer,  then  reads  the  corresponding 
value  from  the  file  to  build  the  message. 

•  Stops  reading  the  file  when  it  detects  an  END_OVERLAY_SETUP  command. 


Called  By: 

tst_ereadconfig 

Routines  Called: 

fscanf 

printf 

strcmp 

Parameters: 

none 

Returns: 

none 

2.17.20.5  setup_p_terrain_feedback 

The  setup_4)_terrain_feedback  function  handles  the  creation  of  the  terrain  feedback  header 
record  specified  in  the  ASCII  viewport  configuration  file,  by  building  a  Simulation  Host- 
type  message.  This  function  is  called  if  the  file  specifies 
START_TERRAIN_FEEDBACK. 

The  function  call  is  setup_p_terrain_feedback().  The  function  does  the  following: 

•  Initializes  a  MSG_TERRAIN_FEEDBACK_SETUP  message. 

•  Reads  the  point  count  from  the  file  and  puts  it  into  the  messge. 


Called  By:  tst_ereadconfig 


Routines  Called:  fscanf 
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Parameters:  none 

Returns:  none 


2.17.20.6  p_terrrain_feedback 

The  p_terrain_feedback  function  handles  the  creation  of  all  terrain  feedback  points  records 
specified  in  the  ASCII  viewport  configuration  file,  by  building  a  Simulation  Host-type 
message.  This  function  is  called  if  the  file  specifies 
START_TERRAIN_FEEDBACK_POINT_INIT. 

The  function  call  is  p_terrain_feedback().  The  function  does  the  following: 

•  Initializes  the  MSG_TERRAIN_FEEDBACK_POINT_INIT  message. 

•  Reads  each  parameter  in  turn  from  the  file  into  the  command  buffer. 

•  Determines  the  parameter  from  the  command  buffer,  then  reads  the  corresponding 
value  from  the  file  to  build  the  message. 

•  Stops  reading  the  file  when  it  detects  an  END_TERRAIN_FEEDB  ACK_- 
POINTJNIT  command. 


Called  By: 

tst_ereadconfig 

Routines  Called: 

fscanf 

printf 

stremp 

Parameters: 

none 

Returns: 

none 

2.17.21  tst_eupdate.c 

The  tst_eupdate  function  can  be  used  to  update  configuration  node  data,  viewport 
parameters,  and  graphics  path  parameters  for  debugging  or  testing  purposes.  This  function 
is  called  if  the  Gossip  user  selects  the  U  ("Update  config  node  and  viewport  information") 
option  from  the  Viewport  Test  menu. 

The  function  call  is  tst_eupdate().  tst_eupdate  presents  a  menu  that  allows  the  user  to 
select  the  data  to  be  chang^.  It  Aen  prompts  the  user  for  the  new  values  and  calls  the 
appropriate  vpt_update_*  function  to  make  the  change. 

The  following  table  lists  the  options  supported  by  tst_eupdate,  and  shows  the  major  steps  it 
performs  for  each  selection. 
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Update  Menu  Option 

Processing  by  tst_eupdate 

0  Update  branch  mask 

Prompts  user  for  configuration  node  index  and  branch 
mask;  calls  vpi_update_tHmask. 

1  Update  4x3  matrix 

Prompts  user  for  configuration  node  index,  time  stamp, 
and  new  matrix;  calls  vpt_update_4x3_mairix. 

2  Update  3x3  matrix 

Prompts  user  for  configination  node  index,  time  stamp, 
heading,  pitch,  roll,  x,  y,  and  z;  calls 
vpt_updaie_3x3_matrix. 

3  Update  hprxyzs 

Prompts  user  fOT  configuration  node  index,  time  stamp, 
heading,  pitch,  roll,  x,  y,  and  z;  calls 
vpt_update_hprxyzs. 

4  Update  translation 

Prompts  user  for  configuration  node  index,  time  stamp, 
and  translation  x,  y,  and  z;  calls  vpt_update_translation. 

5  Update  scale 

Prompts  user  for  configuration  node  index,  time  stamp, 
and  s^e  x,  y,  and  z;  calls  vpt_update_scale. 

6  Update  2x1  heading 

Prompts  user  for  configuration  node  index,  time  stamp, 
and  heading  value;  calculates  rotation  values;  calls 
vpt_update_2x  l_heading. 

7  Update  2x1  pitch 

Prompts  user  for  configuration  node  index,  time  stamp, 
and  pitch  value;  calculates  rotation  values;  calls 
vpt_updaic_2x  l_piich. 

8  Update  2x1  roll 

Prompts  user  for  configuration  node  index,  time  stamp, 
and  roll  value;  calculates  rotation  values;  calls 
vpt_update_2x  1  _roll. 

9  Update  heading 

Prompts  user  fur  configuration  node  index,  time  stamp, 
and  heading  value;  calls  vpt_update_heading. 

A  Update  pitch 

Prompts  user  for  configuration  node  index,  time  stamp, 
and  pitch  value;  calls  vpt_update_pitch. 

B  Update  roll 

Prompts  user  for  configuration  node  index,  time  stamp, 
and  roll  value;  calls  vpt_updaie_roll. 

C  Update  heading,  pitch,  roll 

Prompts  user  for  configuration  node  index,  time  stamp, 
heading,  pitch,  and  roll;  calls  vpt_updatc_hpr. 

D  Update  all  viewport  values 

Prompts  user  for  node  index,  fov  angles,  resolution, 
''iewing  range,  near  plane,  and  lod  multiplier;  calls 
vpt_update_all. 

E  Update  field  of  view 

Prompts  user  fix'  node  index  and  fov  angles;  calls 
vpt_update_fov. 

F  Update  lod  multiplier 

Prompts  user  for  node  index  and  lod  multiplier;  calls 
vpt_update_lodm. 

G  Update  near  plane 

Prompts  user  for  node  index  and  near  plane;  calls 
vpt_uixlate_near_plane. 

H  Update  resolution 

Prompts  user  for  node  index  and  resolution;  calls 
vpt_update_rcz. 

I  Update  viewing  range 

Prompts  user  for  node  index  and  viewing  range;  calls 
vpt_update_view_range. 

J  Update  graphics  path 

Prompts  user  for  node  index,  path  index,  path  fov,  path 
resolution,  and  path  center  in  degrees;  calls 
vpt_update_one_paih . 
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X  Exit 


Exits. 


Called  By:  tst_tree 


Routines  Called:  cos 

printf 
scanf 
sin 

TORAD 

vpt_update_2x  1  _headin  g 

vpt_update_2x  l_pitch 

vpt_update_2x  1  _roll 

vpt_update_3x3_inatrix 

vpt_update_4x3_matrix 

vpt_update_all 

vpt_update_brmask 

vpt_update_fov 

vpt_update_heading 

vpt_update_hpr 

vpt_update_hprxy2s 

vpt_update_lodm 

vpt_update_near_plane 

vpt_update_one_path 

vpt_update_pitch 

vpt_update_rez 

vpt_update_roll 

vpt_update_scale 

vpt_update_translation 

vpt_update_view_range 


Parameters:  none 

Returns:  none 

2.17.22  tstjree.c 

The  functions  in  the  tst_tree.c  CSU  are  used  to  present  a  user  interface  to  the  Viewport 
Configuration  test  routines.  These  functions  are: 

•  tst_tree 

•  mem_check 


2.17.22.1  tst_tree 

The  tst_tree  function  provides  an  interface  for  the  user  for  debug,  update,  and  test  options 
that  can  be  used  to  exercise  the  Viewport  Configuration  tree.  This  function  is  invoked 
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through  Gossip  when  the  user  selects  the  7  ("configtree  menu")  option  from  the  Gossip 
main  menu. 


The  function  call  is  tst_tree().  The  following  table  identifies  the  options  displayed  and 
supported  by  tst_tree,  and  shows  the  steps  it  performs  for  each  user  selection. 


Viewport  Test  Menu  Option 

Processing  by  tst  tree 

?  Display  options 

Displays  this  menu. 

0  Read  configuration  file  and  process 

Calls  tst_ereadconfig. 

1  Change  debug  switches 

Calls  tst_edebug. 

2  Query  mode 

Calls  tst_equery. 

F  Tree  Free 

Calls  vpt_tree_free. 

I  Tree  Initialize 

Calls  vpt_tree_iniL 

M  Memory  alloc  test 

Calls  prini_allocp. 

T  Trace  tree  information 

Calls  tst_treetrace. 

U  Update  config  node  and  viewport 
information 

Calls  ist_eupdate. 

X  Exit 

Exits. 

Called  By: 
Routines  Called: 


gossip_tick 


print_allocp 

printf 

scanf 

tst_edebug 

tst_equery 

tst_ereadconfig 

tst_eupdate 

tst_treetrace 

vpt_tree_free 

vpt_tree_init 


Parameters:  none 

Returns:  none 


2.17.22.2  mem_check 

The  mem_check  function  calls  malloc  to  determine  the  next  available  memory  address, 
displays  the  address,  then  frees  the  memory. 

The  function  call  is  mem_check(). 

This  function  is  not  currently  used. 
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Called  By: 

none 

Routines  Called: 

free 

malloc 

printf 

Parameters: 

none 

Returns: 

none 

2.17.23  tst_treetrace.c 

The  functions  in  the  tst_treetrace.c  CSU  are  used  to  trace  a  node's  path  through  the 
configuration  tree.  These  functions  are: 

•  tst_trcetrace 

•  pr_branch 

•  pr_niatrix 

2.17.23.1  tst_treetrace 

The  tst_treetrace  function,  given  a  node  index,  displays  the  node's  information  and  all 
information  about  the  node's  children.  This  function  is  called  if  the  Gossip  user  selects  the 
T  ("Tree  trace  information")  option  from  the  Viewport  Test  menu. 

The  function  call  is  tst_treetrace().  The  function  does  the  following: 

•  Prompts  the  user  for  the  starting  node  index. 

•  Calls  vpti_get_ptr_cnode  to  get  a  pointer  to  the  starting  node. 

•  Calls  vpt_cnode_query  to  get  information  on  the  starting  node. 

•  If  the  node  is  a  branch  (conditional)  node,  calls  pr_branch  to  display  the 
infomiation.  If  the  node  is  a  matrix  node,  calls  pr_matrix  to  display  the 
information. 

•  If  the  node  has  children,  repeats  the  above  process  for  each  child  node. 

•  Prompts  the  user  for  another  starting  node;  repeats  until  the  user  enters  999. 


Called  By:  lst_tree 


Routines  Called:  pr_branch 

pr_matrix 
printf 
scanf 

vpt_cnode_query 

vpti_get_ptr_cnode 
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Parameters:  none 


Returns:  none 


2.17.23.2  pr_branch 

The  pr_branch  function  displays  information  on  branch  (conditional)  nodes.  This  function 
is  called  by  tst_treetrace  if  Ae  node  to  be  displayed  is  defined  as  a  branch  node. 

The  function  call  is  pr_branch(info),  where  info  is  a  pointer  to  the  configuration  node 
information  structure.  ~ 

pr_branch  outputs  the  node's  node  index,  branch  index,  branch  mask,  and  description.  If 
the  Gvpt_dtree_short  variable  is  set  to  FALSE,  it  also  outputs  the  node's  parent  index,  true 
child  flag,  and  vehicle  id. 


Called  By:  tst_treetrace 


Routines  Called:  printf 

vpti_state_dtree_short 


Parameters:  VPT_CNODE_INFO  ♦info 


Returns:  none 


2.17.23.3  pr_niatrix 

The  pr_matrix  function  displays  information  on  matrix  nodes.  This  function  is  called  by 
tst_treetrace  if  the  node  to  be  ^splayed  is  defined  as  a  matrix  node. 

The  function  call  is  pr_matrix(info),  where  info  is  a  pointer  to  the  configuration  node 
information  structure.  ~ 

pr_matrix  outputs  the  node's  node  index,  matrix  type,  static  matrix  flag,  branch  mask,  and 
description.  If  the  node  has  viewport  parameters  attached,  pr_matrix  outputs  a  statement  to 
that  effect 

If  the  Gvpt_dtree_short  variable  is  set  to  FALSE,  pr_matrix  also  outputs  the  node's  parent 
index,  true  child  flag,  vehicle  id,  and,  if  the  matrix  type  is  RTS4x3,  the  node's  matrix. 


Called  By:  tst_treetrace 


Routines  Called:  printf 

r4mat_dump 
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vpti_state_dtrce_short 


Parameters:  VPT_CNODE_INFO 


*info 


Returns:  none 


2.17.24  u_brinask.c  (vpt_update_brmask) 

The  vpt_update_brmask  function  updates  (changes)  the  branch  mask  of  a  specified 
configuration  node.  This  function  is  called  if  the  Gossip  user  selects  the  0  ("Update  branch 
mask")  option  from  the  Update  menu. 

The  function  call  is  vpt_update_brmask(node_index,  br_mask),  where: 

node  jndex  is  the  unique  index  used  to  reference  this  node 
br  jnask  is  the  new  branch  mask 

vpt_update_brmask  does  the  following: 

•  Gets  a  pointer  to  the  node. 

•  Makes  sure  this  is  not  the  root  node  (node_index  =  0). 

•  Updates  the  node's  branch  mask. 

The  function  returns  SUCCEED  if  it  is  successful.  It  returns  FAIL  if  the  specified  node  is 
the  root  node,  or  if  it  could  not  get  a  pointer  to  the  node. 


Called  By:  tst_eupdate 


Routines  Called:  printf 

vpti_get_ptr_cnode 

vpti_state_dcnode  (in  debug  mode  only) 


Parameters:  INT_2 

UNS_4 


node_index 

br_mask 


Returns:  1  (SUCCEED) 

0(FAIL) 


2.17.25  u_path.c  (vpt_update_one__path) 

The  vpt_update_one_path  function  updates  a  single  graphics  path's  parameters  (field-of- 
view  angles,  resolution,  and  path  center).  This  function  is  called  if  the  Gossip  user  selects 
the  J  ("Update  graphics  path")  option  from  the  Update  menu. 

The  function  call  is  vpt_update_one_path(node_index,  pathjd,  fov,  rez, 
center),  where:  ”  ”  ” 
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node  index  is  the  unique  index  used  to  reference  this  node 

pathjd  identifies  the  graphics  path 

fov  is  the  path's  field-of-view 

rez  is  the  path's  resolution 

center  is  the  center  of  the  path  in  degrees 

vpt_update_one_path  does  the  following: 

•  Gets  a  pointer  to  the  specified  node. 

•  Verifies  that  the  node  has  viewport  parameters  attached  to  it. 

•  Sets  the  new  values. 

•  Calls  vpt_path_update  to  update  the  path  with  the  new  parameters. 

The  function  returns  SUCCEED  if  it  is  successful.  It  returns  FAIL  if  it  cannot  get  a  pointer 
to  the  node,  the  node  does  not  have  viewport  parameters,  or  vpt_path_update  cannot  update 
the  graphics  path. 


Called  By:  tst_eupdate 


Routines  CaUed:  be_query_buffer_offset 

vpt_path_update 

vpti_get_ptr_cnode 


Parameters:  INT_2  node_index 

INT_2  pathjd 

R4IJ  fov 

I4IJ  rcz 

REAL_4  center 


Returns;  1  (SUCCEED) 

0(FAIL) 


2.17.26  u  rotations.c 


The  functions  in  the  u_rotations.c  CSU  update  part  or  all  of  the  rotation  matrix  for  a  given 
configuration  node.  These  functions  are: 


•  vpt_update_2xl_heading 

•  vpt_update_2xl_pitch 

•  vpt_update_2xl_roll 

•  vpt_update_heading 

•  vpt_update_pitch 

•  \^t_update_roll 

•  vpt_update_hpr 
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2.17.26.1  vpt_update_2xl_heading 

The  ypt_update_2xl_hea(iing  function  is  used  to  update  a  matrix  node's  heading.  This 
function  is  called  when  the  Simulation  Host  sends  a  MSG_ROT2xl_MATRIX  message  to 
rotate  an  RTS4x3  matrix  around  axis  0.  It  is  also  invoked  through  Gossip  if  the  user 
selects  the  6  ("Update  2x1  heading")  option  from  the  Update  menu. 

The  function  call  is  vpt_update_2xl_heading(node_index,  tinie_stamp, 
cosrotation,  sinrotatioh),  where: 

node  index  is  the  unique  index  used  to  reference  this  node 
time  stamp  is  the  time  stamped  in  the  Simulation  Host  message 
cosrotation  is  the  cosine  of  the  angle  of  rotation 
sinrotation  is  the  sine  of  the  angle  of  rotation 

vpt_update_2xl_heading  calls  vpt_update_rot  to  perform  the  indicated  rotation.  It  then 
returns  the  status  return^  from  vpt_update_rot:  SUCCEED  or  FAIL. 


Called  By: 

msg_rot2x  1  _matrix 
tst_eupdate 

Routines  Called: 

printf 

vpt_update_rot 

Parameters: 

INT  2 

node_index 

INT  2 

time_stamp 

REAL  4 

cosrotation 

REAL_4 

sinrotation 

Returns; 

status 

2.17.26.2  vpt_update_2xl_pitch 

The  vpt_update_2xl_pitch  function  is  used  to  update  a  matrix  node's  pitch.  This  function 
is  called  when  the  Simulation  Host  sends  a  MSG_ROT2xl_MATRIX  message  to  rotate  an 
RTS4x3  matrix  around  axis  1.  It  is  also  invoked  through  Gossip  if  the  user  selects  the  7 
("Update  2x1  pitch")  option  from  the  Update  menu. 

The  function  call  is  vpt_update_2xl_pitch(node_index,  time^stamp, 
cosrotation,  sinrotatioh),  where:  -  -  - 

node  index  is  the  unique  index  used  to  reference  this  node 
time  stamp  is  the  time  stamped  in  the  Simulation  Host  message 
cosrotation  is  the  cosine  of  the  angle  of  rotation 
sinrotation  is  the  sine  of  the  angle  of  rotation 
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vpt_update_2xl_pitch  calls  vpt_update_rot  to  perform  the  indicated  rotation.  It  then 
returns  the  status  returned  from  vpt_update_rot:  SUCCEED  or  FAIL. 


Called  By: 

msg_rot2x  l_matrix 
tst_eupdate 

Routines  Called: 

printf 

vpt_update_rot 

Parameters: 

INT  2 

node_index 

INT  2 

time_stamp 

REAL  4 

cosrotation 

REAL_4 

sinrotation 

Returns: 

status 

2.17.26.3  vpt_update_2xl_roIl 

The  vpt_update_2xl_roll  function  is  used  to  update  a  matrix  node’s  roll.  This  function  is 
called  when  the  Simulation  Host  sends  a  MSG_ROT2xl_MATRIX  message  to  rotate  an 
RTS4x3  matrix  around  axis  2.  It  is  also  invoked  through  Gossip  if  the  user  selects  the  8 
("Update  2x1  roll")  option  from  the  Update  menu. 

The  function  call  is  vpt_update_2xl_r6ll(node_index,  time^stamp,  cosrotation, 
sinrotation),  where: 

nodejndex  is  the  unique  index  used  to  reference  this  node 
time  stamp  is  the  time  stamped  in  the  Simulation  Host  message 
cosrotation  is  the  cosine  of  Ae  angle  of  rotation 
sinrotation  is  the  sine  of  the  angle  of  rotation 

vpt_update_2xl_roll  calls  vpt_update_rot  to  perform  the  indicated  rotation.  It  then  returns 
the  status  returned  from  vpt_update_rot;  SUCCEED  or  FAIL. 


Called  By: 

msg_rot2x  1  _matrix 
tst_cupdate 

Routines  Called: 

printf 

vpt_update_rot 

Parameters: 

INT  2 

node_index 

INT  2 

time_stamp 

REAL  4 

cosrotation 

REAL  4 

sinrotation 
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Returns;  status 


2.17.26.4  vpt_update_heading 

The  vpt_update_heading  function  is  used  to  update  a  matrix  node's  heading.  This  function 
is  called  when  the  Simulation  Host  sends  a  MSG_1  ROTATION  noessage  to  rotate  an 
HPRXYZS  matrix  around  axis  0  (heading).  It  is  also  invoked  through  Gossip  if  the  user 
selects  the  9  ("Update  heading")  option  from  the  Update  menu. 

The  function  call  is  vpt_update_heading(node_index,  tiine_stamp,  rotation), 
where: 

node  index  is  the  unique  index  used  to  reference  this  node 
time  stamp  is  the  time  stamped  in  the  Simulation  Host  message 
rotation  is  the  angle  of  rotation  in  degrees 

vpt_update_heading  calls  vpt_update_rot  to  perform  the  indicated  rotation.  It  then  returns 
the  status  returned  from  vpt_update_rot:  SUCCEED  or  FAIL. 


Called  By; 

msg_lrotation 

tst_eupdatfc 

Routines  Called: 

ptintf 

vpt_update_rot 

Parameters: 

INT  2 

node_index 

INT  2 

time_stamp 

REAL_4 

rotation 

Returns: 

status 

2.17.26.5  vpt_update_pitch 

The  vpt_update_pitch  function  is  used  to  update  a  matrix  node’s  pitch.  This  function  is 
called  when  the  Simulation  Host  sends  a  MSG_1  ROTATION  message  to  rotate  an 
HPRXYZS  matrix  around  axis  1  (pitch).  It  is  also  invoked  through  Gossip  if  the  user 
selects  the  A  ("Update  pitch")  option  from  the  Update  menu. 

The  function  call  is  vpt_update_pitch(node_index,  time_stamp,  rotation),  where; 

node  jndex  is  the  unique  index  used  to  reference  this  node 
time  stamp  is  the  time  stamped  in  the  Simulation  Host  message 
rotation  is  the  angle  of  rotation  in  degrees 

vpt_update_pitch  calls  vpt_update_rot  to  perform  the  indicated  rotation.  It  then  returns  the 
status  returned  from  vpt_update_tot:  SUCCEED  or  FAIL. 
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Called  By: 

msg_lrotation 

tst_eupdate 

Routines  Called: 

printf 

vpt_update_rot 

Parameters: 

INT  2 

node_index 

INT  2 

time_stamp 

REAL_4 

rotation 

Returns: 

status 

2.17.26.6  vpt_update_ron 

The  vpt_update_roll  function  is  used  to  update  a  matrix  node's  roll.  This  function  is  called 
when  the  Simulation  Host  sends  a  MSG_1  ROTATION  message  to  rotate  an  HPRXYZS 
matrix  around  axis  2  (roll).  It  is  also  invoked  through  Gossip  if  the  user  selects  the  B 
("Update  roll")  option  from  the  Update  menu. 

The  function  call  is  vpt_update_rolI(node_index,  time_stamp,  rotation),  where: 

nodejndex  is  the  unique  index  used  to  reference  this  node 
time_stamp  is  the  time  stamped  in  the  Simulation  Host  message 
rotation  is  the  angle  of  rotation  in  degrees 

vpt_update_roll  calls  vpt_update_rot  to  perform  the  indicated  rotation.  It  then  returns  the 
status  returned  from  vpt_u^ate_rot:  SUCCEED  or  FAIL. 


Called  By: 

msg_lrotation 

tst_eupdate 

Routines  Called: 

printf 

vpt_update_rot 

Parameters: 

INT  2 

node_index 

INT  2 

time_stamp 

REAL_4 

rotation 

Returns: 

status 

2.17.26.7  vpt_update_hpr 

The  vpt_update_hpr  function  is  used  to  update  a  matrix  node’s  heading,  pitch,  and  roll. 
This  function  is  called  when  the  Simulation  Host  sends  a  MSG_3ROTATIONS  message 
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for  an  HPRXYZS  matrix.  It  is  also  invoked  through  Gossip  if  the  user  selects  the  C 
("Update  heading,  pitch,  roll")  option  from  the  Update  menu. 

The  function  call  is  vpt_update_hpr(node_index,  time_stamp,  h,  p,  r),  where: 


nodejndex  is  the  unique  index  used  to  reference  this  node 
time  stamp  is  the  time  stamped  in  the  Simulation  Host  message 
h  is  the  new  heading  in  degrees 
p  is  the  new  pitch  in  degrees 
r  is  the  new  roll  in  degrees 

vpt_update_hpr  calls  vpt_update_rot  to  perform  the  indicated  rotations.  It  then  returns  the 
status  returned  from  vpt_u^ate_rot:  SUCCEED  or  FAIL. 


Called  By: 

msg_3rotations 

tst_eupdate 

Routines  Called: 

printf 

vpt_update_rot 

Parameters: 

INT  2 

node_index 

INT  2 

time  stamp 

REAL  4 

h 

• 

REAL  4 

REAL_4 

P 

r 

Returns: 

status 

2.17.27  u_viewport.c 

The  functions  in  the  u_viewport.c  CSU  are  used  to  update  a  configuration  node's  viewport 
parameters.  These  functions  are: 


•  vpt_update_fov 

•  vpt_update_fov_lod 

•  vpt_update_lodm 

•  vpt_update_near_4)lane 

•  vpt_update_rez 

•  vpt_update_view_range 

•  vpt_update_all 


Most  of  these  functions  are  currently  used  only  for  testing  (via  Gossip). 


2.17  27.1  vpt_update_fov 

The  vpt_update_fov  function  is  used  to  update  a  viewport  node's  field-of-view.  This 
function  is  invoked  through  Gossip  if  the  user  selects  the  E  ("Update  field  of  view")  option 
from  the  Update  menu. 
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The  function  call  is  vpt_update_fov(index,  fov),  where: 

index  is  the  viewport  node's  index 
fov  is  the  new  field-of-view 

vpt_update_fov  gets  a  pointer  to  the  viewport  parameters,  then  calls  vpt_update  to  perform 
the  ui^te.  The  function  returns  the  status  (SUCCEED  or  FAIL)  returned  from 
vpt_update.  It  returns  FAIL  if  it  could  not  get  a  pointer  to  the  viewport  parameters. 


Called  By:  tst_eupdate 


Routines  Called:  be_query_buffer_offset 

vpt_update 

vpti_get_vptptr_cnode 


index 

fov 


Returns:  status 

0(FAIL) 


Parameters:  INT_2 

R4IJ 


2.17.27.2  vpt_update_fov_lod 

The  vpt_update_fov_lod  function  updates  a  viewport  node's  field-of-view  and  level-of- 
detail  multiplier.  This  function  is  c£illed  when  the  Simulation  Host  sends  a 
MSG_VIEW_MAGNIFICATION  message. 

The  function  call  is  vpt_update_fov_lod(index,  fov,  lod),  where: 

index  is  the  viewport  node's  index 
fov  is  the  new  field-of-view  value 
lod  is  the  new  level-of-detail  value 

vpt_update_fov_lod  gets  a  pointer  to  the  viewport  parameters,  then  calls  vpt_update  to 
perform  the  update.  The  function  returns  the  status  (SUCCEED  or  FAIL)  returned  from 
vpt_update.  It  returns  FAIL  if  it  could  not  get  a  pointer  to  the  viewport  parameters. 


Called  By:  msg_view_magnification 


Routines  Called:  be_query_buffer_offset 

vpt_update 

vpti_get_vptptr_cnode 


Parameters:  INT_2 

R4IJ 


index 

fov 
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REAL_4 


lod 


Returns:  status 

0(FAIL) 


2.17.27.3  vpt_update_lodin 

The  vpt_update_lodm  function  is  used  to  update  a  viewport  node's  level-of-detail 
multiplier.  This  function  is  invoked  through  Gossip  if  the  user  selects  the  F  ("Update  lod 
multiplier")  option  from  the  Update  menu. 

The  function  call  is  vpt_updateJodm(index,  lod  multiplier),  where: 

index  is  the  viewport  node's  index 
lod  multiplier  is  the  new  level-of-detail 

vpt_update_lodm  gets  a  pointer  to  the  viewport  parameters,  then  calls  vpt_update  to 
perform  the  update.  The  function  returns  the  status  (SUCCEED  or  FAIL)  returned  from 
vpt_update.  It  returns  FAIL  if  it  could  not  get  a  pointer  to  the  viewport  parameters. 


Called  By:  tst_eupdate 


Routines  Called:  be_queiy_buffer_offset 

vpt_update 

vpti_get_vptptr_cnode 


Parameters: 

INT  2 

index 

REAL_4 

lod_multiplier 

Returns: 

status 

0(FAIL) 

2.17.27.4  vpt_update_near_plane 

The  vpt_update_near_plane  function  is  used  to  update  a  vie\\^ort  node's  near  plane  (the 
closest  point  that  can  ^  seen  from  the  viewport).  This  function  is  invoked  through  Gossip 
if  the  user  selects  the  G  ("Update  near  plane”)  option  from  the  Update  menu. 

The  function  call  is  vpt_update_near_plane(index,  near_plane),  where: 

index  is  the  viewport  node's  index 
near  jj/one  is  the  near  plane  value 

vpt_update_near_plane  gets  a  pointer  to  the  viewport  parameters,  then  calls  vpt_update  to 
perform  the  update.  The  function  returns  the  status  (SUCCEED  or  FAIL)  return^  from 
vpt_update.  It  returns  FAIL  if  it  could  not  get  a  pointer  to  the  viewport  parameters. 
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Called  By:  tst_eupdate 


Routines  CaUed:  be_query_buffer_offset 

vpt_update 

vpti_5et_vptptr_cnode 


Parameters:  INT_2 

REAL_4 


index 

near_plane 


Returns:  status 

0(FAIL) 


2.17.27.5  vpt_update_rez 

The  ypt_update_rez  function  is  used  to  update  a  viewport  node’s  screen  resolution.  This 
function  is  invoked  through  Gossip  if  the  user  selects  the  H  ("Update  resolution")  option 
from  the  Update  menu. 

The  function  call  is  vpt_update_rez(index,  rez),  where: 

index  is  the  viewpon  node's  index 
rez  is  the  new  screen  resolution 

vpt_update_rez  gets  a  pointer  to  the  viewport  parameters,  then  calls  vpt_update  to  perform 
the  update.  The  function  returns  the  status  (SUCCEED  or  FAIL)  returned  from 
vpt_update.  It  returns  FAIL  if  it  could  not  get  a  pointer  to  the  viewport  parameters. 


Called  By:  tst_eupdate 


Routines  Called:  be_query_buffer_offset 

vpt_update 

vpti_get_vptptr_cnode 


index 

rez 


Returns:  status 

0(FAIL) 


Parameters:  INT_2 

I4U 


2.17.27.6  vpt_update_view_range 

The  vpt_update_view_range  function  is  used  to  update  a  viewport  node's  viewing  range 
(the  distance  that  can  be  seen  from  the  viewport).  This  function  is  invoked  through  Gossip 
if  the  user  selects  the  I  ("Update  viewing  range")  option  from  the  Update  menu. 
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The  function  call  is  vpt_update_view_range(index,  viewing_range),  where: 

index  is  the  viewport  node's  index 
viewing  range  is  the  viewing  range  in  meters 

vpt_update_view_range  gets  a  pointer  to  the  viewport  parameters,  then  calls  vpt_update  to 
p^orm  the  update,  'file  function  returns  the  status  (SUCCEED  or  FAIL)  returned  from 
vpt_update.  It  returns  FAIL  if  it  could  not  get  a  pointer  to  the  viewport  parameters. 


Called  By:  tst_eupdate 


Routines  Called:  be_query_buffer_offset 

vpt_update 

vpti_get_vptptr_cnode 


Parameters: 

INT  2 

index 

REAL_4 

viewing_range 

Returns: 

status 

0(FAIL) 

2.17.27.7  vpt_update_all 

The  ypt_update_all  function  is  used  to  update  all  dynamic  parameters  associated  with  a 
specified  viei^^rt.  This  function  is  invoked  through  Gossip  if  the  user  selects  the  D 
("Update  all  viewport  values")  from  the  Update  menu. 

'The  function  call  is  vpt_update_all(lndex,  fov,  rez,  viewing_range, 
near_plane,  lod^multiplier),  where:  ~ 

index  is  the  viewport  node's  index 
fov  is  the  new  field-of-view  value 
rez  is  the  new  resolution 

viewing  range  is  the  new  viewing  range  in  meters 

near  jylane  is  the  new  near  plane  value 

lod  rnultiplier  is  the  new  level-of-detail  multiplier 

vpt_update_all  gets  a  pointer  to  the  viewport  parameters,  then  calls  vpt_update  to  perform 
the  update.  'The  function  returns  the  status  (SUCCEED  or  FAIL)  returned  from 
vpt_update.  It  returns  FAIL  if  it  could  not  get  a  pointer  to  the  viewport  parameters. 


Called  By:  tst_eupdate 


Routines  Called:  be_query_buffer_offset 

vpt_update 

vpti_get_vptptr_cnode 
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Parameters: 

INT  2 

index 

R4IJ 

fov 

I4IJ 

lez 

REAL  ^ 

viewing_range 

REAL  4 

near_plane 

REAL_4 

lod_multiplier 

Returns: 

status 

0(FAIL) 

2.17.28  u_xfrm.c 

The  functions  in  the  u_xfnm.c  CSU  process  changes  to  the  transformation  matrices  in  the 
configuration  tree.  These  functions  are: 

•  vpt_update_4x3_matrix 

•  vpt_update_3x3_matrix 

•  vpt_update_hprxyzs 

•  vpt_update_scale 

•  vpt_update_translation 


2.17.28.1  vpt_update_4x3_matrix 


The  vpt_update_4x3_matrix  function  is  used  to  replace  the  matrix  of  a  configuration  node 
defin^  with  a  matrix  type  of  RTS4x3_'n[TE.  This  function  is  called  when  the  Simulation 
Host  sends  a  MSG_RTS4x3_MATRIX  message.  It  is  also  invoked  through  Gossip  if  the 
user  selects  the  1  ("Update  4x3  matrix")  option  from  the  Update  menu. 


The  function  call  is  vpt_update_4x3_matrix(node_index,  time_stamp,  matrix), 
where: 


nodejndex  is  the  unique  index  used  to  reference  this  node 
time  stamp  is  the  time  stamped  in  the  Simulation  Host  message 
matrix  is  the  new  transformation  matrix 


vpt_update_4x3_matrix  calls  vpt_update_mtx  to  perform  the  actual  update,  then  returns  the 
status  (SUCCEED  or  FAIL)  returned  from  vpt_update_mtx. 


Called  By:  msg_rts4x3_matrix 

tst_eupdate 


Routines  Called:  printf 

vpt_update_mtx 


Parameters:  INT_2 

INT_2 


node_index 

time_stamp 
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MTXUNION 


*matrix 


Returns:  status 


2.17.28.2  vpt_update_3x3_matrix 

The  vpt_update_3x3_matrix  function  is  used  to  replace  the  matrix  of  a  configuration  node 
defin^  with  a  matrix  type  of  RTS3x3_TYPE.  This  function  is  invoked  through  Gossip  if 
the  user  selects  the  2  ("Update  3x3  matrix")  option  from  the  Update  menu. 

The  function  call  is  vpt_update_3x3_matrix(node_index,  time_stamp,  matrix), 
where: 

node  index  is  the  unique  index  used  to  reference  this  node 
time  stamp  is  the  time  stamped  in  the  Simulation  Host  message 
matrix  is  the  new  transformation  matrix 

vpt_update_3x3_matrix  calls  vpt_update_mtx  to  perform  the  actual  update,  then  returns  the 
status  (SUCCEED  or  FAIL)  returned  from  vpt_update_mtx. 


Called  By: 

tst_eupdate 

Routines  Called: 

printf 

vpt_update_mtx 

Parameters: 

INT  2 

node_index 

INT  2 

time_stamp 

MTXUNION 

♦matrix 

Returns: 

status 

2.17.28.3  vpt_update_hprxyzs 

The  vpt_update_hprxyzs  function  is  used  to  replace  the  matrix  of  a  configuration  node 
delink  with  a  matrix  type  of  RTS3x3_TYPE.  This  function  is  called  when  the  Simulation 
Host  sends  a  MSG_HPRXYZS  message.  It  is  also  invoked  through  Gossip  if  the  user 
selects  the  3  ("Update  hprxyzs")  option  from  the  Update  menu. 

The  function  call  is  vpt_update_hprxyzs(node_index,  time_stamp,  matrix), 
where: 

nodejndex  is  the  unique  index  used  to  reference  this  node 
time  stamp  is  the  time  stamped  in  the  Simulation  Host  message 
matrix  is  the  new  transformation  matrix 

vpt_update_hprxyzs  calls  vpt_update_mtx  to  perform  the  actual  update,  then  returns  the 
status  (SUCCEED  or  FAIL)  returned  from  vpt_update_mtx. 
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Called  By:  msg_hprxyzs_  matrix 

tst_eupdate 


Routines  Called:  printf 

vpt_update_mtx 


Parameters: 


INT_2 

INT_2 

MTXUNION 


node_index 

dme_stamp 

♦matrix 


Returns:  status 


2.17.28.4  vpt_update_scale 

The  vpt_update_scale  function  is  used  to  change  the  scale  value  of  a  configuration  node 
defm^  with  a  matrix  type  of  HPRXYZS_TYre.  This  function  is  called  when  the 
Simulation  Host  sends  a  MSG_SCALE  message.  It  is  also  invoked  through  Gossip  if  the 
user  selects  the  5  ("Update  scale")  option  from  the  Update  menu. 

The  function  call  is  vpt_update_scale(node_index,  time_stamp,  x,  y,  z),  where: 

nodejndex  is  the  unique  index  used  to  reference  this  node 
time  stamp  is  the  time  stamped  in  the  Simulation  Host  message 
X  is  the  new  x  scale  factor 
y  is  the  new  y  scale  factor 
z  is  the  new  z  scale  factor 

vpt_update_scale  calls  vpt_update_mtx  to  perform  the  actual  update,  then  returns  the  status 
(SUCCEED  or  FAIL)  returned  from  vpt_update_mtx. 

N  ote:  The  MSG_SCALE  message  is  reserved  for  future  expansion. 


Called  By: 

msg_scale 

tst_eupdate 

Routines  Called: 

printf 

vpt_update_mtx 

Parameters: 

INT  2 

node_index 

INT  2 

time_stamp 

REAL  4 

X 

REAL  4 

y 

REAL  4 

z 
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Returns:  status 


2,17.28.5  vpt_update_translation 

The  vpt_update_translation  function  is  used  to  change  the  translation  value  of  a 
configuration  node  defined  with  a  matrix  type  of  HPRXYZS_TYPE.  This  function  is 
called  when  the  Simulation  Host  sends  a  MSGJTRANSLATTON  message.  It  is  also 
invoked  tiwough  Gossip  if  the  user  selects  the  4  ("Update  translation")  option  from  the 
Update  menu. 

The  function  call  is  vpt_update_translation(node_index,  time_stamp,  x,  y,  z), 
where: 

node  index  is  the  unique  index  used  to  reference  this  node 
time  stamp  is  the  time  stamped  in  the  Simulation  Host  message 
X  is  the  new  x  translation  value 
y  is  the  new  y  translation  value 
z  is  the  new  z  translation  value 

vpt_update_translation  calls  vpt_update_mtx  to  perform  the  actual  update,  then  returns  the 
status  (SUCCEED  or  FAIL)  returned  from  vpt_update_mtx. 


Called  By: 

msg_translation 

tst_eupdate 

Routines  Called: 

printf 

vpt_update_mtx 

Parameters: 

INT  2 

node_index 

INT  2 

time_stamp 

REAL  4 

X 

REAL  4 

y 

REAL_4 

z 

Returns: 

status 

2.17.29  update_mtx.c  (vpt_update_nitx) 

The  vpt_update_mtx  function  replaces  or  modifies  the  transformation  matrices  in  the 
configuration  tree.  This  function  is  called  by  the  functions  in  the  u_xfrm.c  CSU,  which  in 
turn  are  called  when  the  Simulation  Host  sends  messages  to  update  matrices,  and  when  the 
Gossip  user  selects  an  option  to  change  a  matrix. 

The  function  call  is  vpt_update_mtx(node_index,  time_stamp,  matrix_type, 
matrix),  where:  ~  ~ 

node  jndex  is  the  unique  index  used  to  reference  this  node 
time  stamp  is  the  time  stamped  in  the  Simulation  Host  message 
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matrix  type  is  0  (HPRXYZS  matrix),  1  (RTS4x3  matrix),  or  2  (ROT2xl  matrix) 

matrix  is  a  pointer  to  the  new  matrix 

vpt_update_mtx  does  the  following: 

•  Gets  a  pointer  to  the  node. 

•  Verifies  that  this  is  not  the  root  node;  returns  an  error  and  terminates  if  it  is. 

•  If  the  complete  matrix  is  being  changed,  calls  mtxcpy  to  copy  the  new  matrix  to  the 
configuration  node. 

•  If  only  the  scale  or  translation  is  being  changed,  changes  the  values  in  the  matrix  in 
the  configuration  node. 

•  Calls  concat_mtx  to  update  the  copy  of  the  matrix  used  by  DTP. 

•  If  this  is  a  hull/world  node  (i.e.,  a  child  of  the  root  node),  calls  process_vppos  to 
update  the  simulated  vehicle's  current  position. 

The  function  returns  SUCCEED  if  it  is  able  to  update  the  matrix.  It  returns  FAIL  if  it 
cannot  get  a  pointer  to  the  node  or  the  specified  node  is  the  root  node. 


Called  By: 

vpt_update_3x3_matrix 

vpt_update_4x3_matrix 

vpt_update_hprxyzs 

vpt_update_scale 

vpt_update_translation 

Routines  Called: 

concat_mtx 

mtxcpy 

printf 

process_vppos 

vpti_get_ptr_cnode 

vpti_state_dcnode  (in  debug  mode  only) 

Parameters: 

INT  2 

node_index 

INT  2 

time_stamp 

UNS_1 

matrix_type 

Returns: 

1  (SUCCEED) 

0(FAIL) 

2.17.30  update_rot.c 

(vpt_update_rot) 

The  vpt_update_rot  function  updates  the  rotation  values  in  the  transformation  matrices  in 
the  configuration  tree.  This  function  is  called  by  the  functions  in  the  u_rotations.c  CSU, 
which  in  turn  are  called  when  the  Simulation  Host  sends  messages  to  rotate  matrices,  or  the 
Gossip  user  selects  an  option  to  rotate  a  matrix. 

The  function  call  is  vpt  update_rot(node_index,  time_stamp,  type, 
rotation_axis,  rotation),  wher^:  ~ 

node  index  is  the  unique  index  used  to  reference  this  node 
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time_stamp  is  the  time  stamped  in  the  Simulation  Host  message 
type  is  the  type  of  rotation:  ROT2xl_TYPE,  ROTl_TYPE  (for  one  rotation),  or 
ROTSJITPE  (for  three  rotations) 

rotation  axis  is  the  axis  to  be  rotated:  0  (heading),  1  (pitch),  or  2  (roll) 
rotation  is  the  angle  of  rotation 

vpt_update_rot  does  the  following: 

•  Gets  a  pointer  to  the  node. 

•  Verifies  that  this  is  not  the  root  node;  returns  an  error  and  terminates  if  it  is. 

•  Updates  the  rotation  value(s)  in  the  node's  matrix,  based  on  the  node's  matrix  type 
and  the  rotation  type  specific  in  the  call. 

•  Calls  concat_mtx  to  update  the  copy  of  the  matrix  used  by  DTP. 

•  If  this  is  a  hull/world  node  (i.e.,  a  child  of  the  root  node),  caUs  process_vppos  to 
update  the  simulated  vehicle's  current  position. 

The  function  returns  SUCCEED  if  it  is  able  to  update  the  matrix.  It  returns  FAIL  if  it 
cannot  get  a  pointer  to  the  node  or  the  specified  node  is  the  root  node. 


Called  By:  vpt_update_2xl_heading 

vpt_update_2x  l_pitch 
vpt_update_2x  1  _roll 
vpt_update_heading 

vpt_update_hpr 

vpt_update_pitch 

vpt_update_roIl 

Routines  Called:  concat_mtx 

printf 

process_vppos 

vpti_get_ptr_cnode 

vpti_state_dcnode 

(in  debug  mode  only) 

Parameters:  INT  2 

INT  2 

UNS  1 

UNS  1 

REAL_4 

node_index 

time_stamp 

type 

rotation_axis 

♦rotation 

Returns:  1  (SUCCEED) 

0(FAIL) 

2.17.31  vpt_get.c  (vpt_vpt_get) 

The  vpt_vpt_get  function  allocates  memory  for  a  new  viewport  parameter  node  and  returns 
a  pointer  to  it.  This  function  is  called  whenever  a  configuration  node  with  viewpon 
parameters  attached  to  it  is  defined. 

The  function  call  is  vpt_vpt_get().  The  function  does  the  following: 
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•  Verifies  that  the  viewport  parameters  array  will  hold  another  pointer. 

•  Allocates  memory  for  the  new  viewport  parameters. 

•  Verifies  that  the  memory  was  allocated. 

•  Places  the  new  entry  in  the  viewport  parameters  pointers  table  (Gvpt_vpt_pointers). 

•  Increments  the  Gvpt_vpt_entry_index. 

If  successful,  the  function  retvuns  a  pointer  to  the  viewport  parameters  entry  as  viewpt. 


Called  By:  vpt_vpt_process 


Routines  Called:  calloc 

printf 

vpti_increment_vpt_entry_index 

vpti_set_ptr_vpt 

vpti_val_vpt_entry_index 


Parameters:  none 


Returns:  viewpt 


2.17.32  vpt^process.c  (vpt_vpt_process) 

The  vpt_vpt_process  function  creates  and  iititializes  viewport  parameters  entries  in  the 
viewport  configuration  tree.  This  function  is  called  whenever  a  node  with  viewport 
parameters  attached  to  it  is  defined. 

The  function  call  is  vpt_vpt_process(node_index,  viewport_id,  database  id, 
fov,  resolution,  viewing_range,  near_plane,  lod_multiplier,  aspect_ratio, 
n_vpts),  where:  ”  ~ 

node  index  is  the  unique  index  used  to  reference  this  node 

viewport _id  is  the  identifier  assigned  to  this  viewport 

database  id  is  the  database  identifier  (for  future  use) 

fov  is  the  viewport's  field-of-view 

resolution  is  the  viewport's  screen  resolution 

viewing  range  is  the  distance  that  can  be  viewed  from  the  viewport 

near  jjlane  is  the  closest  point  that  can  be  seen  from  the  viewport 

lod  rnultiplier  is  the  viewport's  level-of-detail  multiplier 

aspect  ratio  is  the  ratio  of  the  sides  (width:height)  of  the  viewport  (for  future  use) 

n  vpts  is  the  number  of  viewports 

vpt_vpt_process  does  the  following: 

•  Calls  vpt_vpt_get  to  get  a  pointer  for  the  new  viewport  node. 

•  Calls  vpt_cnode_linl^t  to  set  the  node's  pointer  to  the  correct  index  in  the  view 
positions  array. 

•  Calls  be_query_num_paths  to  determine  how  many  graphics  paths  are  needed. 

•  Sets  the  offset  to  0  (for  double  buffer  0). 


662 


BBN  Systems  and  Technologies 


GTIOO  RTSW  CSCI 


•  Calls  be_query_lm_per_lmb_side  to  get  the  number  of  load  modules  per  load 
module  block  side.  This  value  is  used  to  scale  the  images  in  the  viewport  for  the 
larger  viewing  range  if  load  module  blocking  is  enabled. 

•  Set  the  number  of  viewports. 

•  Calls  vpt_vpt_set  to  place  the  viewport  parameter  data  in  the  configtiration  tree. 

The  function  returns  SUCCEED  if  the  viewport  parameters  are  initialized  successfully.  It 
returns  FAIL  if  the  pointer  to  the  vppos  array  could  not  be  set,  graphics  paths  could  not  be 
allocated,  or  viewport  setup  failed. 


Called  By: 


Routines  Called: 


Parameters: 


Returns: 


cig_config 

p_viewport_state 


be_query_lm_per_lmb_side 

be_query_num_paths 

printf 

vpt_cnode_linkvpt 

vpt_vpt_jet 

vpt_vpt_set 

vpti_state_dvptnode 


INT_2 

INT_2 

UNS_1 

R4IJ 

I4U 

REAL_4 
REAL_4 
REAL_4 
REAL_4 
UNS  2 


1  (SUCCEED) 
0(FAIL) 


(in  debug  mode  only) 


node_index 

viewpon_id 

databasejd 

fov 

resolution 

viewing_range 

near_plane 

lod_multiplier 

aspect_ratio 

n_vpts 


2.17.33  vpt_query.c  (vpt_vpt_query) 

The  vpt_vpt_query  function  copies  the  viewport  parameters  node  information  to  a  query 
structure  that  can  be  displayed  through  Gossip.  This  function  is  used  for  testing  only. 

The  function  call  is  vpt_vpt_query(vp,  vi),  where: 

\p  is  a  pointer  to  the  viewport  parameters 
vr  is  a  pointer  to  the  query  structure 

The  function  zeroes  out  the  query  structure  before  copying  the  new  data  to  it. 


Called  By: 


vptq_vpout 
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Routines  Called:  none 


Paranaeters: 


Returns: 


VIEWPORT_PARAMETERS 
VPT  VPT  INFO 


none 


*vp 

*vi 


2.17.34  vpt_set.c  (vpt_vpt_set) 

The  vpt_vpt_set  function  places  new  viewport  parameter  data  into  the  configuration  tree. 
This  function  is  called  whenever  a  node  with  viewport  parameters  is  defined. 


The  function  call  is  vpt_vpt_set(viewport,  node_index,  viewporMd, 
database_id,  fov,  rezr  viewing_range,  near_plane,  lod_muIti^lier, 
aspect_ratio,  paths_i,  paths_j,  start_path_id,  offset),  where: 


viewport  is  a  pointer  to  the  viewport  parameters 

node  index  is  the  unique  index  used  to  reference  this  node 

viewport  id  is  the  identifier  assigned  to  this  viewport 

datcdjose  id  is  the  database  identSier  (for  future  use) 

fov  is  the  viewport's  field-of-view 

resolution  is  the  viewport's  screen  resolution 

viewing  range  is  the  ^stance  that  can  be  viewed  from  the  viewport 

near  jjlane  is  the  closest  point  that  can  be  seen  from  the  viewport 

lod  multiplier  is  the  viewport's  level-of-detail  multiplier 

aspect  ratio  is  the  ratio  of  the  sides  (width:height)  of  the  viewport  (for  future  use) 

paths  J  is  the  number  of  graphics  paths  in  the  i  direction 

paths  J  is  the  number  of  graphics  paths  in  the  j  direction 

start  jjath  id  is  a  pointer  to  the  first  graphics  path 

ojfset  is  the  offset  to  the  current  double  buffer  (always  0  for  initialization) 


vpt_vpt_set  does  the  following: 

•  Allocates  active  area  memory  for  the  values  required  by  the  DTP  (near  plane,  lod 
multiplier,  and  viewing  range). 

•  Fill  the  viewport  node  with  the  parameters  passed  in. 

•  Calls  vpt_path_setup  to  allocate  and  fill  the  graphics  paths  data. 

•  Calls  vpt_update  to  set  the  final  dynamic  viewport  data. 


The  function  returns  SUCCEED  if  the  viewport  parameters  are  added  successfully.  It 
returns  FAIL  if  active  area  memory  could  not  be  allocated. 


Called  By:  vpt_vpt_process 


Routines  Called: 


aam_malloc 

printf 

vpt_path_setup 
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Parameters: 


Returns: 


vpt_update 

vpti_get_ptr_cnode 

vpti_state_dvptnode 

(in  debug  mode  only) 

INT  2 

node_index 

INT  2 

viewport_id 

UNS  1 

databasejd 

R4U 

fov 

I4U 

rez 

REAL  4 

viewing_range 

REAL  4 

near_plane 

REAL  4 

lod_multiplier 

REAL  4 

aspect_ratio 

INT  2 

paths_i 

INT  2 

pathsj 

INT  2 

start_path_id 

UNS_4 

offset 

1  (SUCCEED) 

0(FAIL) 

2,17.35  vpt_update.c 

The  vpt_update  function  finalizes  the  viewport  parameters  data,  then  calls  vpt_path_process 
to  fin^ze  the  viewport's  graphics  paths  data.  This  function  is  called  for  each  viewport 
node  defined  at  initialization  time.  It  is  also  called  whenever  a  viewport  node  is  updated 
with  the  MSG_VIEW_MAGNIFICATION  message  or  through  Gossip. 

The  function  call  is  vpt_update(viewport,  fov,  rez,  viewing_range,  near_plane, 
lod_inultipIier,  offset)?  where: 

viewport  is  a  pointer  to  the  viewport  parameters 
fov  is  the  viewport's  field-of-view 
rez  is  the  viewport's  screen  resolution 

viewing  range  is  the  distance  that  can  be  viewed  from  the  viewport 
near  jjlane  is  the  closest  point  that  can  be  seen  from  the  viewport 
lod  multiplier  is  the  viewport's  level-of-detail  multiplier 
offset  is  the  offset  to  the  current  double  buffer 

vpt_update  does  the  following: 

•  Verifies  that  the  near  plane,  lod  multiplier,  and  viewing  range  have  been  allocated. 

•  Fills  the  viewport  node. 

•  Sets  the  near  and  far  plane  values. 

•  Calculates  the  level-of-detail  multiplier  based  on  the  field  of  view  and  the  horizontal 
screen  resolution. 

•  Loads  the  level-of-detail  multiplier. 

•  Calls  vpt_path_process  to  set  the  graphics  paths. 
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The  function  returns  SUCCEED  if  the  viewport  node  is  added  successfully.  It  returns 
FAIL  if  no  viewport  parameters  were  specified,  any  of  the  allocatable  values  were  not 
allocated,  the  graphics  paths  could  not  be  set,  or  no  viewport  node  was  specified. 


Called  By; 

vpt_update_all 

vpt_update_fov 

vpt_update_fov_lod 

vpt_update_lodm 

vpt_update_near_plane 

vpt_update_rez 

vpt_update_view_range 

vpt_vpt_set 

Routines  Called: 

printf 

tan 

TORAD 

vpt_path_process 

Parameters: 

VIEWPORT  PARAMETERS 
R4IJ 

I4U 

REAL  4 

REAL  4 

REAL  4 

REAL  4 

UNS_4 

♦viewport 

fov 

lez 

scale 

viewing_range 

near_plane 

lod_multiplier 

offset 

Returns: 

1  (SUCCEED) 

0(FAIL) 
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2.18  Force  Processing  (/cig/othersrc/force) 

The  Force  Processing  CSC  gives  the  GTIOO  CIG  the  ability  to  display  two-dimensional, 
non-perspective  visual  data  as  an  overlay  on  top  of  the  three-dimensional,  perspective 
image  of  the  database.  The  Force  task  is  the  task  that  runs  on  the  Force  board  and  serves 
as  the  data  processing  interface  between  the  CIG  real-time  task  and  the  2-D  processor  task. 
The  Force  board  is  the  physical  interface  between  the  VME  chassis  and  the  2-D  processor 
board.  This  CSC  is  present  on  TX  backends  only. 

The  real-time  software  provides  2-D  overlay  information  to  the  Force  board  via  the  Force 
task.  The  Force  task  then  writes  the  data  to  the  GSP,  the  graphics  processor  chip  on  the 
MPV  (Micro  Processor  Video)  board.  The  GSP  contains  memory  for  code  storage  and  for 
storing  and  manipulating  the  2-D  image.  The  Force  board  can  also  read  data  from  GSP 
memory  about  particular  attributes  of  the  displayed  image. 

The  Force  task  communicates  with  the  GSP  to  do  the  following: 

Display  the  2-D  overlays. 

The  original  2-D  overlay  configuration  is  passed  to  Force  by  the  linkup  function  in 
the  2-D  Overlay  Compiler  component.  The  configuration  includes  the  component 
pointer  table,  component  descriptor  table,  and  window  descriptor  table.  These 
structures  are  downloaded  into  GSP  memory  and  used  to  generate  the  overlays 
displayed  on  the  viewports. 

Change  the  2-D  overlays  during  runtime. 

Each  frame,  runtime  changes  to  2-D  components  are  passed  to  Force  from  the  real¬ 
time  software.  Each  message  consists  of  the  command  (CHANGE_DRAW_2D, 
DRAW_TEXT_2D,  ROTATE_TRANSLATE_2D,  etc.)  and  any  arguments  (theta, 
X  translation,  y  translation,  etc.)  required  for  that  command.  Processing  for  these 
messages  is  as  follows: 

1 .  The  Simulation  Host  sends  a  MSG_PASS_ON  message  to  specify  the  2-D 
component  changes. 

2 .  The  real-time  software  writes  the  message  to  Force  memory. 

3 .  The  Force  task  writes  the  message  to  GSP  memory. 

4.  The  GSP  parses  each  command  in  the  message,  updates  the  component 
descriptor  table  in  its  memory,  then  regenerates  the  2-D  overlays. 

A  new  PASS_ON  message  is  expected  every  frame.  If  none  is  sent,  the  Force  task 
reprocesses  the  last  PASS_ON  message  it  received. 

The  format  for  each  2-D  runtime  command  is  described  in  the  "2-D  Commands  and 
Parameters"  document. 

Return  messages  to  simulation. 

Messages  such  as  error  reports  can  be  returned  from  Force  to  the  Simulation  Host. 
The  Force  task  places  the  data  in  Force  board  memory.  The  real-time  software  puts 
the  data  into  a  MSG_PASS_BACK  message  and  returns  it  to  the  Simulation  Host. 
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Process  laser  range  request  messages. 

The  Simulation  Host  can  use  the  MSG_REQUEST_LASER_RANGE  message  to 
request  the  depth  of  the  pixel  located  at  the  screen  i^sition  represented  by  i,  j, 
where  i  is  the  horizontal  coordinate  (column)  and  j  is  the  vertical  coordinate  (row). 
The  real-time  software  uses  the  pOTce  interface  to  request  the  pixel  depth 
informadon  from  the  MPV.  The  real-time  software  takes  the  returned  value  and 
sends  a  MSG_LASER_RETURN  message  to  the  Simulation  Host. 

Process  mail. 

This  process  triggers  the  Force/MPV  interface  to  send  and  receive  data  such  as  pass 
on,  pass  back,  and  laser  range  request  messages. 

Download  and  change  the  2-D  and  3-D  color  lookup  tables. 

The  2-D  (final)  and  3-D  lookup  tables  are  downloaded  to  the  GSP  memory  through 
the  Force-MPV  interface.  The  active  lookup  table  can  be  changed  using  the 
MSG_SUBSYS_MODE  message. 

Turn  the  video  channels  on  and  off. 

The  MPV  video  channels  can  be  controlled  using  the  MSG_VIEWPORT_UPDATE 
message. 

Change  MPV  modes. 

The  MPV  mode  defines  the  viewport's  resolution,  panel  orientation,  and  image 
offset.  A  viewport's  mode  can  be  changed  using  the  MSG_SUBSYS_MODE 
message. 

Start  or  stop  the  GSP  task. 

The  MPV  Interface  CSC  starts  the  GSP  task  initially,  and  stops  and  restarts  it  when 
testing  GSP  memory.  GSP  can  also  be  stopped  and  restarted  via  Gossip. 

Test  reading  from/writing  to  GSP  memory. 

GSP  memory  testing  is  performed  by  the  MPV  Interface  CSC  at  GSP  initialization 
time.  Memory  testing  can  also  be  invoked  through  Gossip. 

The  force  and  GSP  tasks  are  initially  loaded  and  started  by  functions  in  the  MPV  Interface 
CSC,  when  the  MPV  is  initialized.  The  MPV  Interface  routines  and  the  Force  board 
communicate  using  two  different  interface  methods:  message  buffers  and  the  Force  front- 
end  control  register. 

Message  Buffers 

Messages  are  passed  using  half-word  message  buffers.  Messages  sent  from  the 
real-time  software  (via  the  MPV  Interface  routines)  to  Force  are  prefixed  with 
MSG_F0.  Messages  returned  from  Force  are  prefixed  with  MSG_F1. 

Both  the  MPV  Interface  functions  and  the  Force  functions  use  the  routines  in  the 
mx2_hword.c  CSU  to  manage  and  use  the  message  buffers.  This  CSU  is  pan  of 
both  the  Real-Time  Processing  CSC  and  the  Force  Processing  CSC. 

Force  Front-End  Control  Register 

For  some  functions,  the  MPV  friterface  routines  place  commands  directly  into  the 
Force  board's  front-end  control  register  (FE_CONTROL).  This  interface  uses  an 
intertask  mailbox.  The  commands  are  queued  in  the  Force-MPV  mailbox  until  the 
end  of  the  frame,  at  which  time  a  message  is  sent  to  Force  to  trigger  processing  of 
the  queued  commands. 
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Messages  passed  between  the  real-time  software  and  the  2-D  processor  task  (on  the  GSP) 
arc  handled  in  a  different  manner: 

•  The  Simulation  Host  sends  "pass  on"  messages  to  update  2-D  overlays  during  the 
simulation.  The  message  is  received  by  process_a_msg,  which  calls  an  MPV 
Interface  routine.  The  MPV  Interface  function  places  the  message  in  an  outgoing 
buffer  (data_buf_out ). 

•  After  processing  a  "pass  on"  message,  the  GSP  sends  a  "pass  back"  message  in 
reply.  The  message  is  placed  in  an  incoming  buffer  (data_buf_in).  The  MPV 
Interface  routine  sets  a  pointer  to  the  message  for  return  to  the  Simulation  Host. 

•  The  above  scenario  applies  only  to  changes  to  the  2-D  overlays.  The  original 
overlays  created  before  the  simulation  starts  (using  the  2-D  C^erlay  Compiler)  are 
not  passed  through  the  MPV  Interface  routines.  The  2-D  Overlay  Compiler's 
linkup  function  places  the  GSP  download  commands  directiy  into  the 
FE_CONTROL  register. 

The  Gossip  user  can  interact  with  the  MPV  and  the  GSP  through  the  gos_mpvio  function, 
as  follows: 

1 .  The  user  selects  option  4  ("120tx  menu")  from  the  Gossip  main  menu. 

2.  The  user  selects  option  H  ("MPV/Force  message  interface")  from  the  120tx  menu. 

3 .  The  Message  Interface  -  RTSW  to  Force  Message^  menu  appears.  This  menu  can 
be  used  to  send  messages  to  the  Force  board. 

The  Force  Processing  functions  used  to  process  messages  from  the  real-time  software  are 
named  in  the  format  fO_<message>.  There  is  a  separate  function  for  each  message  type 
supported.  The  functions  are  defined  in  the  FG_message_table[]  array,  which  is  defined 
by  the  initjump_table  function.  The  fl_process_messages  function  indexes  into  this  array 
to  call  the  correct  function  for  each  message  it  receives. 

The  message  buffers  used  as  the  interface  between  the  real-time  software  and  Force  are 
summarized  below.  The  name  shown  in  quotation  marks  in  the  Buffer  Name  column  is  the 
name  used  in  this  section  to  refer  to  that  buffer. 


Buffer  Name 

Purpose/Contents 

Messages  Pushed  By 

Messages  Popped  By 

FG_to_force_buf 
(”to_force  buffer") 

Messages  from  the  real¬ 
time  software  that  affect 
the  simulation. 

various  Ubmpvideo 
functions 

n_process_messages 

FG_fiDm_force_buf 
(''from_force  buffer”) 

Responses  to  real-time 
messages. 

f0_*  functions 

various  Ubmpvideo 
functions 

FG_force_query_buf 
("f<Mce_queiy  buffer") 

Messages  from  Gossip 
for  testing/debugging. 

gos_mpvio 

fl_process_messages 

FG_f(Wce_rcply_buf 
("force_reply  buffer") 

Responses  to  Gossip 
messages. 

ro_*  functions 

gos_mpvio 
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When  an  f0_*  function  is  called,  the  calling  function  passes  it  a  paratneter  that  identifies 
which  outgoing  buffer  to  use  for  its  response  messages. 

The  following  table  identifies  all  messages,  in  alphabetical  order,  that  may  be  passed  from 
the  real-time  software  or  Gossip  to  Force  Pressing.  TTie  table  also  identifies  the 
function(s)  in  the  real-time/Gossip  software  that  push  the  message  onto  the  to_force  or 
force_query  buffer,  and  the  Force  Processing  function  that  processes  the  message. 


RTSW  ->  Force 

Message 

Sent  From 
(RTSW  Function) 

Processed  By 
(Force  Function) 

MSG_FO_3DLUT_DOWNLOAD 

gos_mpvio, 

mpvideo_sim_init 

fD_3d]ut_down]oad 

MSG_P0_3DLUT_SWITCH 

gos_mpvio,  mpvideo_set_lut 

f0_3dlul_switch 

MSG_FO_ALLLUT_SWITCH 

gos_mpvio,  mpvideo_set_lut 

fO_alllut_swiich 

MSG_FO_DEBUG_DISABLE 

gos_nipvio 

fO_debug_disable 

MS3_F0_DEBUG_ENABLE 

gos_mpvio 

fO_debug_enable 

MSG_FO_FINAL_LUT_DOWNLOAD 

gos_mpvio,  mpvidco_load 

fD_final_lut_download 

MSG_FO_FINAL_LUT_SWITCH 

gos_mpvio,  mpvidco_set_Iut 

ro_final_lul_swiich 

MSG_FO_MODE_SELECT 

gos_mpvio, 

mpvidM_set_modc 

ro_modc_seIect 

MSG_F0_MPV_INIT 

gos_mpvio 

fO_mpv_inil 

MSG_FO_MPV_LUT_TYPE_REQUEST 

gos_mpvio,  mpvideo_booi 

fD_mpv_lul_typc_rcqucsi 

MSG_F0_MPV_PEEK 

gos_mpvio 

fO_mpv_peck 

MSG_FO_MPV_POKE 

gos.mpvio 

f0_mpv_poke 

MSG_FO_MPV_POKE16 

gos_mpvio 

f0_mpv_pokcl6 

MSG_FO_MPV_RESET 

gos_mpvio,  mpvideo_boot 

fD_inpv_rc.sct 

MSG_PO_MPV_TASK_CONTROL 

gos_mpvio 

fD_nipv_iask_conuol 

MSG_FO_MPV_TEST 

gos_mpvio 

fO_mpv_test 

MSG_FO_MPV_WRITE 

gos_mpvio 

fO_mpv_wriie 

MSG_FO_PASS_ON 

none 

f0_pass_on 

MSG_FO_PIXEL_DEPTH_REQUEST 

gos_mpvio, 

mpvidM_laser_request_range 

ro_pixel_depih_requesi 

MSG_F0_QUERY 

gos_mpvio 

fD_qucry 

MSG_FO_SET_DISPLAY 

gos_mpvio, 

mpvidTO_set_video 

ro_set_display 

MSG_F0_TRIGGER 

gos_mpvio, 

mpvidro_send_req 

ro_trigger 

The  next  table  identifies  all  messages,  in  alphabetical  order,  that  may  be  returned  from 
Force  to  the  real-time  software  or  Gossip.  The  table  also  identifies  the  Force  function(s) 
that  push  the  message  onto  the  fTOm_force  or  force_reply  buffer,  and  the  function(s)  in  the 
real-time/Gossip  software  that  process  it. 
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Force  ->  RTSW 

Message 

Sent  From 
(Force  Function) 

Processed  By 
(RTSW  Function) 

msg_fi_acknowledge 

f0_3dlut_download, 

f0_3dlut_switch, 

fO_alUut_switch, 

fD_debug_disable, 

f0_debug_enable, 

fD_final_Iul_download, 

fO_final_lut_switch, 

fO_inode_selecl, 

fO_mpv_poke, 

fl3_mpvjpokel6, 

fO_mpv_reset,  fO_mpv_write 

fO_pass_on.  fO_set_display. 

gspjo 

gos_mpvio,  mpvideo_boot, 
mpvid^_load, 
mpvideo_response,  prtackcrr 

MSG_Fl_MPV_IOCT 

fD_trigger 

gos_mpvio, 

mpvideo_response 

MSG_F1_MPV_LUT_TYPE 

K)_mpv_iut_type_rcquest 

gos_mpvio,  mpvideo_boot, 
mpvideo_response 

MSG_Fl_MPV_MEMORY 

fO_mpv_peek 

gos_mpvio, 

mpvid^_response 

MSG_F1_PIXEL_ADDR 

ro_pixel_depth_request 

gos_mpvio, 

mpvid^_rcsponse 

MSG_F1_PIXEL_DEPTH_RETURN 

fO_trigger 

gos_mpvio, 

inpvid^_response 

MSG_F1_STATUS 

none 

gos_mpvio, 

mpvideo_response,  prtstateir 

MSG_F1_TEXT 

fD_qucry 

gos_mpvio, 

mpvideo_response 

The  typedefs  that  define  the  structures  of  all  Force-RTSW  messages  are  contained  in  the 
mpvideo_msg.h  file. 

The  following  table  illustrates  the  stmcture  of  the  Force-MPV  software  mailboxes.  This 
structure  is  defined  in  the  mpv_mdef.h  file. 
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Offset 


0x00000000 


0x00001800 


0x00001820 


0x00001840 


0x00001850 


0x00001860 


0x00001870 


0x00001880 


0x00001890 


Ox000018AO 


0x000018B0 


Ox000018CO 


0x00001800 


0x07801F00 


0x07801F20 


0x7801F30 


0x07801F40 


Ox07801F50 


0x07801F60 


0x07801F80 


0x07801FA0 


0x07801FB0 


0x7800000  (channel  0) 


MPV_BUFF_1N0 


mpv_buff_outo 


PIXEL_REQUEST_OA 


PIXEL_REQUEST_0B 


PIXEL_I_LOC_0A 


PIXEL_J_LOC_0A 


PIXEL_DEPTH_0A 


PIXEL_I_LOC_0B 


PIXEL_J_LOC_0B 


PIXEL_DEPTH_0B 


PIXEL_ID_0A 


PIXEL  ID  OB 


0x7802000  (channel  1) 


MPV_BUFF_IN1 


MPV_BUFF_OUTl 


PIXEL_REQUEST_1A 


PIXEL_REQUEST_1B 


PIXEL_I_LOC_lA 


PrXEL_J_LOC_lA 


PIXEL_DEPTH_1A 


PIXEL_l_LOC_lB 


PIXEL_J_LOC_lB 


PIXEL_DEPTH_1B 


PIXEL_ID_1A 


PIXEL  ID  IB 


0x000018E0 

SWn’CH_2DLUT_FLAG_0 

SWITCH_2DLUT_FLAG_1 

0x000018F0 

NEW_2DLUT_VALUE_0 

NEW_2DLIJT_VALUE_1 

0x00001900 

SWITCH_MODE_FLAG_0 

SWITCH_MODE_FLAG_l 

0x00001910 

NEW_MODE_0 

NEW_MODE_l 

0x00001920 

NEW_HSBLNK_0 

NEW_HSBLNK_1 

0x00001930 

NEW_HEBLNK_0 

NEW_HEBLNK_1 

0x00001940 

NEW_VSBLNK_0 

NEW_VSBLNK_1 

0x00001950 

NEW_VEBLNK_0 

NEW_VEBLNK_1 

0x0780  lEOO 

ILLOP_FLAG 

Ox07801E10 

ILLOP.COUNT 

0x0780 1E20 

ILLOP.ADDRESS 

0x07801E40 

ILLOP_OPCODE 

CLUT_ADDR_PTR 


CLUT_LOADED_FLAG 


CLUT_A_SWITCH_FLAG 


CLUT_B_SWITCH_FLAG 


NEW_CLUT_A_ADDR 


NEW_CLUT_B_ADDR 


CLUT_A_SWITCH_ACK 


CLUT_B_SWITCH_ACK 
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Figure  2-22  identifies  the  CSUs  in  the  Force  Processing  CSC.  The  functions  performed 
by  these  CSUs  are  described  in  this  section. 


exception. asm 
f0_3dlut_download 
f0_3dlut_switch.c 
fO_alllut_switch.c 
fO_debug_disable.c 
fO_debug_enable.c 
fO_final_lut_download.c 
fO_f  i  nal_iut_switch  .c 
fO_mode_select.c 
f0_mpvjnit.c 
f0_mpvjut_request.c 
fO_mpv_peek.c 


f0_mpvj3oke16.c 
fO_mpv_reset.c 
fO_mpv_task_control  .c 
fO_mpv_test.c 
fO_mpv_write.c 
f0j3ass_on.c 
f0j3ixel_depth_request.c 
fO_query.c 
fO_set_display.c 
fOJrigger.c 
fO  unknown.c 


f1_initjump_table.c 

f1  j3ixel_address.c 

f1  _process_messages.c 

f1_setup_environment.c 

force.asm 

forcetask.c 

gspjo.c 

mx2_hword.c 

nmi_type.c 

polLready.c 

test_gsp.c 


Figure  2-22.  Force  Processing  CSUs 


2.18.1  data_type.c 

The  data_type  function  reads  data  from  and  writes  data  to  GSP  memory.  This  function  is 
called  by  main  (in  forcetask.c)  if  the  command  in  the  FE_CONTROL  register  is 
SUBSYS_READ_START,  SUBSYS_WRITE_START,  SUBSYS_READ_MORE,  or 
SUBSYS_WRITE_MORE. 

The  function  call  is  data_type().  data_type  does  the  following: 

•  Retrieves  the  type  of  front-end  command:  read  data  or  write  data. 

•  If  the  command  is  read  data: 

-  Calls  gsp_ioctl_write  to  set  the  GSP  host  control  word  for  read  mode. 

-  Calls  gsp_read  to  read  the  data  as  specified  by  the  command. 

•  If  the  command  is  write  data: 

-  Calls  gsp_ioctl_write  to  set  the  GSP  host  control  word  for  write  mode. 

-  Calls  gsp_write  to  write  the  data  as  specified  by  the  command. 

-  Reads  the  data  back  and  verifies  it  with  compare_buffers. 


Called  By:  main 
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Routines  Called: 


compare_buffers 

gsp_ioctl_write 

gsp_rcad 

gsp_write 


Parameters; 


Returns: 


none 


none 


2.18.2  exception.asm 

The  functions  in  the  exception.asm  CSU  are  used  to  initialize  the  exception  vector  table. 
These  functions  are: 

•  excep_init 

•  spur_int 


2.18.2.1  excep_init 


The  excep_init  function  first  determines  the  base  address  of  the  Force  board  from  the 
current  code.  It  then  initializes  the  vector  base  register  (VBR)  of  the  68010  and  all  entries 
in  the  exception  vector  table  to  point  to  spurjnt. 

The  function  call  is  excep_init(). 


Called  By: 

fl_force_init 

Routines  Called: 

spur_int 

Parameters: 

none 

Returns: 

none 

2.18.2.2  spurjnt 

The  spurjnt  function  disables  interrupts,  then  saves  all  of  the  68010  data  registers  into  the 
structure  "context."  The  order  of  the  save  is  as  follows:  D0-D7,  A0-A6,  SSP,  USP,  PC, 
SR. 

The  function  call  is  spur_int(). 


Called  By: 


excepjnit 
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Routines  Called: 

Parameters: 

Returns: 


none 

none 

none 


2.18.3  f0_3dlut_download.c 

The  f0_3dlut_download  function  processes  the  MSG_FO_3DLIJT_DOWNLOAD 
message.  This  message  is  sent  by  mpvideo_sim_init  at  the  beginning  of  a  simulation  to 
download  16  3-D  color  lookup  tables.  The  message  can  also  be  sent  through  Gossip  by 
selecting  the  1  ("3D_LUT_DOWNLOAD")  option  from  the  gos_mpvio  menu.  After  the 
tables  are  downloaded,  one  can  be  put  into  effect  using  the  MSG_ro_3DLlJT_SWITCH  or 
MSG_FO_ALLLUT_SWITCH  message. 

The  function  call  is  fO_3dlut_downIoad(message_P,  buffer_P),  where: 

message  P  is  a  pointer  to  the  MSG_FO_3DLUT_DOWNLOAD  message 
buffer _P  is  a  pointer  to  the  buffer  to  be  used  for  the  response  message 

f0_3dlut_download  does  the  following: 


Pushes  a  MSG_Fl_ACKNOWLEIX}E  message  onto  the  response  buffer  with  the 
acknowledgement  code  set  to  0. 

Calls  gsp_ioctl_write  to  set  the  GSP  host  control  word  for  read  mode. 

Calls  gsp_read  to  read  the  color  lookup  tables  into  Force  memory. 

If  the  16  tables  are  found: 

-  Uses  gsp_wTite  to  download  the  3-D  color  lookup  tables  from  Force 
memory  into  the  2-D  task  tables  in  GSP  memory. 

-  Verifies  the  data  back  with  gsp_read. 

-  Calls  gsp_write  to  write  the  lookup  table  loaded  flag  to  GSP  memory. 

-  Sets  the  FG_3dlut_downloaded_flag  to  TRUE. 

Pushes  a  MSG_Fl_ACKNOWLEDGE  message  onto  the  response  buffer, 
with  the  acknowledgement  code  set  to  1  (success). 

If  the  tables  are  not  found: 

-  Sets  FG_3dlut_downloaded_flag  to  FALSE. 

-  Pushes  a  MSG_Fl_ACKNOWLEDGE  n^ssage  onto  the  response  buffer, 
with  the  acknowledgement  code  set  to  OxFFFF  (error). 

Calls  gsp_write  to  write  the  lookup  table  switch  acknowledgement  flags  to  GSP 
memory. 

Calls  gsp_ioctl_write  to  set  the  GSP  host  control  word  for  write  mode. 

Calls  gsp_write  to  download  the  tables  to  the  appropriate  addresses  in  the  MPV. 


The  function  returns  the  status  received  from  mx2_push. 


Called  By:  fl_process_messages  (through  *FG_message_table) 


Routines  Called: 


gsp_ioctl_write 
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gsp_read 

gsp_write 

mx2_push 


Parameters:  UNS_4  *message_P 

UNS_4  ♦buffer_P 


Returns:  status 


2.18.4  f0_3dlut_switch.c 

The  f0_3dlut_switch  function  processes  the  MSG_F0_3DLUT_SWITCH  message.  This 
message  is  used  to  put  a  specified  3-D  color  lookup  table  into  effect  (The  table  must  have 
already  been  downloaded  to  the  GSP.)  The  message  is  sent  by  mpvideo_set_lut  if  the 
Simulation  Host  sends  a  MSG_SUBSYS_MODE  message  that  specifies  only  a  new  3-0 
table.  The  message  can  also  be  sent  through  Gossip  by  selecting  the  2 
("3D_LUT_S WITCH")  option  from  the  gos_mpvio  menu. 

The  function  call  is  fO_3dlut_switch(message_P,  buffer_P),  where: 

message  P  is  a  pointer  to  the  MSG_F0_3DLUT_SWITCH  message 
bi/^erj*  is  a  pointer  to  the  buffer  to  be  used  for  the  response  message 

fO_3dlut_switch  does  the  following: 

•  If  the  FG_3dlut_downloaded_flag  is  TRUE  (3-D  color  lookup  tables  have  been 
downloaded  by  fO_3dlut_download): 

-  Calls  gsp_ioctl_write  to  set  the  GSP  host  control  word  for  write  mode. 

-  Calls  gsp_write  to  write  the  new  table  address  in  the  GSP  and  set  the  GSP’s 
switch  flag  for  the  specified  channel. 

-  Calls  gsp_write  to  write  the  appropriate  acknowledgement  flag  to  the  GSP. 

-  Pushes  a  MSG_Fl_ACKNOVh^EDGE  message  onto  the  response  buffer, 
with  the  acknowledgement  code  set  to  the  new  table  id  (success).. 

•  If  the  FG_3dlut_download^_flag  is  FALSE  (f0_3dlut_download  did  not 
download  tables): 

Pushes  a  MSG_Fl_ACKNOWLEDGE  message  onto  the  response  buffer 
with  the  acknowledgement  code  set  to  OxFFFF  (error). 

The  function  always  returns  0. 


Called  By:  fl_process_messages  (through  *FG_message_table) 


Routines  Called:  gsp_ioctl_write 

gsp_write 
mx2_push 


Parameters: 


MSG_F0_3DLUT_SW1TCH  ♦message.P 

UNS_4  *buffer_P 
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Returns:  0 


2.18.5  fO_alllut_switch.c 

The  fO_alllut_switch  function  processes  the  MSG_FO_ALLLUT_SWITCH  message.  This 
message  is  used  to  put  both  a  new  3-D  lookup  table  and  a  new  final  (2-D)  lookup  table  into 
effect.  The  3-D  table  must  have  already  been  downloaded  to  the  GSP.  The  message  is 
sent  by  mpvideo_set_lut  if  the  Simulation  Host  sends  a  MSG_SUBSYS_MODE  message 
that  specifies  both  a  new  3-D  table  and  a  new  2-D  table.  The  message  can  also  be  sent 
through  Gossip  by  selecting  the  3  ("ALL_LIJT_SWITCH")  option  ftom  the  gos_mpvio 
menu. 

The  function  call  is  fO_allIut_switch(message_P,  buffer_P),  where: 

message  P  is  a  pointer  to  the  MSG_FO_ALLLUT_SWrrCH  message 
bi^er  P  is  a  pointer  to  the  buffer  to  be  used  for  the  response  message 

fO_alllut_switch  does  the  following: 

•  Calls  gsp_ioctl_read  to  read  the  GSP  host  control  word. 

•  Calls  gsp_ioctl_write  to  modify  the  host  control  word  to  set  the  data  strobe  bit  on; 
this  signals  the  GSP  that  I/O  is  required. 

•  Determines  the  MPV  buffer  base  address  from  the  host  control  word. 

•  Calls  gsp_ioctl_write  to  set  the  host  control  word  for  write  mode. 

If  FG_3dlut_downloaded_flag  is  TRUE  (f0_3dlut_download  has  downloaded  3-D 
color  tables): 

-  Gets  the  new  3-D  table  id  from  the  message. 

-  Finds  the  table  in  Force  memory. 

-  Finds  the  correct  address  in  GSP  memory. 

-  Calls  gsp_write  to  download  the  table  to  GSP  memory. 

•  If  FG_3dlut_downloaded_flag  is  FALSE  (f0_3dlut_download  has  not  downloaded 
3-D  color  tables): 

-  Sets  the  3-D  table  id  to  OxOOFF  (error). 

•  Gets  the  new  2-D  table  id  from  the  message. 

•  Calls  gsp_write  to  download  the  new  2-D  table  to  GSP  memory. 

•  Pushes  a  MSG_Fl_ACKNOWLEDGE  message  onto  the  response  buffer,  the 
acknowledgement  code  is  set  to  the  new  2-D  table  value  OR’d  with  the  new  3-D 
table  value  (which  is  OxOOFF  if  3-D  tables  have  not  been  downloaded  to  the  GSP). 

The  function  always  returns  0. 


Called  By:  fl_process_messages  (through  *FG_message_table) 


Routines  Clalled:  gsp_ioctl_read 

gsp_ioctl_write 
gsp_write 
mx2_push 
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Parameters: 


MSG_FO_ALLLUT_SWITCH  *message_P 

UNS_4  ♦buffer.P 


Returns:  0 


2.18.6  fO_debug_(lisable.c 

The  fO_debug_<iisable  function  processes  the  MSG_FO_DEBUG_DISABLE  message. 

This  message  is  used  to  disable  Force  debug  mode.  The  message  can  be  generated  toough 
Gossip  by  selecting  the  L  ("DEBUG  DISABLE")  option  on  the  gos_mpvio  menu. 

At  the  current  time,  the  Force  debug  flag  is  used  only  by  gsp_io.  If  debug  is  enabled, 
gsp_io  retiuns  a  status  message. 

The  function  call  is  fO_debug_disabIe(message_P,  buffer_P),  where: 

message  P  is  a  pointer  to  the  MSG_FO_DEBUG_DISABLE  message 
buffer _P  is  a  pointer  to  the  buffer  to  be  used  for  the  response  message 

fO_debug_disable  does  the  following: 

*  Pushes  a  MSG_Fl_ACKNOWLEDGE  message  onto  the  response  buffer,  with  the 
acknowledgement  code  set  to  0  (success). 

•  Sets  the  FG_debug_flag  variable  to  FALSE. 

The  function  returns  the  status  received  from  mx2_push. 


Called  By:  fl_process_messages  (through  *FG_message_table) 

Routines  Called:  mx2_push 


Parameters:  UNS_4  *message_P 

UNS.4  *buffer_P 


Returns:  status 


2.18.7  f0_debug_enable.c 

The  fO_debug_enable  function  processes  the  MSG_FO_DEBUG_ENABLE  message.  This 
message  is  used  to  enable  Force  debug  mode.  The  message  is  generated  through  Gossip 
by  selecting  the  K  ("DEBUG  ENABLE")  option  from  the  gos_mpvio  menu. 

At  the  current  time,  the  Force  debug  flag  is  used  only  by  gsp_io.  If  debug  is  enabled, 
gspjo  returns  a  status  message. 

The  function  call  is  fO_debug_enable(message_P,  buffer_P),  where: 
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message  P  is  a  pointer  to  the  MSG_FO_DEBUG_ENABLE  message 
bi0er_P  is  a  pointer  to  the  buffer  to  be  used  for  the  response  message 

fO_debug_enable  does  the  following: 

*  Pushes  a  MSG_Fl_ACKNOWLEDGE  message  onto  the  response  buffer,  with  the 
acknowledgement  code  set  to  0  (success). 

•  Sets  the  FG_debug_flag  variable  to  TRUE. 

The  function  returns  the  status  received  from  mx2_push. 


Called  By: 


fl_process_messages  (through  *FG_message_table) 


Routines  Called:  mx2_push 


*message_P 

*buffer_P 


Returns:  status 


Parameters:  UNS_4 

UNS_4 


2.18.8  fO_finaMut_download.c 

The  fO_final_lut_download  function  processes  the  MSG_FO_FINAL_LUT_DOWNLOAD 
message.  This  message  is  used  to  download  the  final  (2-D)  color  lookup  table  to  the  GSP. 
The  message  is  sent  by  mpvideojoad  if  the  Simulation  Host  sends  a  MSG_FILE_DESCR 
message  that  specifies  a  final  lookup  table.  The  message  can  also  be  generated  through 
Gossip  by  selecting  the  4  ("FINAL_LUT_DWNLD”)  option  from  the  gos_mpvio  menu. 

The  function  call  is  fO_finaMut_download(message_P,  buffer_P),  where: 

message  P  is  a  pointer  to  the  MSG_FO_FINAL_LUT_DOWNLOAD  message 
bi^erj*  is  a  pointer  to  the  buffer  to  be  used  for  the  response  message 

fO_final_lut_download  does  the  following: 

•  If  FG_final_lut_type  is  0  (2-D  table  cannot  be  downloaded  to  this  MPV  board  — 
final  lookup  table  is  stored  in  PROM): 

-  Pushes  a  MSG_Fl_ACKNOWLEDGE  message  onto  the  response  buffer, 
with  the  acknowledgement  code  set  to  OxFFFF  (error). 

•  If  the  en^  number  in  the  message  is  greater  than  or  equal  to  192  (the  maximum 
allowed  is  191): 

-  Pushes  a  MSG_Fl_ACKNOWLEDGE  message  onto  the  response  buffer, 
with  the  acknowledgement  code  set  to  OxFFFE  (error). 

•  If  the  FG_final_lut_type  is  1  (this  MPV  board  has  downloadable  memory  for 
lookup  tables)  and  the  entry  number  is  valid: 

-  Finds  the  specified  entry's  table  and  address  offsets. 

-  Finds  the  appropriate  destination  address  in  the  MPV. 

-  For  each  two  bytes  of  data  in  the  message  (maximum  256,  or  5 12  bytes): 

*  Calls  gsp_write  to  write  the  data  to  the  GSP. 
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*  Calls  gsp_rcad  to  read  the  data  back  to  compare  it. 

-  Calls  gsp_iocU_write  to  set  the  GSP  host  control  word  for  write  mode. 

-  Calls  gsp_write  to  download  all  of  the  data  from  the  message  to  GSP 
memory. 

-  Pushes  a  MSG_Fl_ACKNOWLEDGE  message  onto  the  response  buffer, 
with  the  acknowledgement  code  set  to  the  entry  number  from  the  message. 

The  function  always  returns  0. 


Called  By:  f  l_process_messages  (through  ♦FG_message_table) 


Routines  Called:  gsp_read 

gsp_write 
mx2_push 


Parameters: 


MSG_FO_FINAL_LUT_DOWNLOAD  *message_P 

UNS_4  *buffer_P 


Returns:  0 


2.18.9  fO_finaMut_switch.c 

The  fO_final_lut_switch  function  processes  the  MSG_FO_FINAL_LUT_SWITCH 
message.  This  message  is  used  to  put  a  specified  final  (2-D)  color  lookup  table  into  effect. 
The  message  is  sent  by  mpvideo_set_lut  if  the  Simulation  Host  sends  a 
MSG_SUBSYS_MODE  message  that  specifies  only  a  new  2-D  table.  The  message  can 
also  be  generated  through  Gossip  by  selecting  the  5  ("F1NAL_LUT_SWITCH")  option 
from  the  gos_mpvio  menu. 

The  function  call  is  fO_rinaI_Iut_switch(message_P,  buffer_P),  where: 

message  P  is  a  pointer  to  the  MSG_FO_FINAL_LUT_SWITCH  message 
bi^er  P  is  a  pointer  to  the  buffer  to  be  used  for  the  response  message 

ro_final_lut_switch  does  the  following; 

•  Calls  gsp_ioctl_read  to  read  the  GSP  host  control  word. 

•  Calls  gsp_ioctl_write  to  change  the  GSP  host  control  word  to  set  the  data  strobe  bit 
on;  this  signals  the  GSP  that  VO  is  required. 

•  Determines  the  MPV  buffer  base  address  from  the  host  control  word. 

•  Calls  gsp_ioctl_write  to  set  the  GSP  host  control  word  for  write  mode. 

•  Gets  the  new  2-D  table  id  (value)  from  the  message. 

•  Calls  gsp_write  to  download  the  new  2-D  table  to  GSP  memory. 

•  Pushes  a  MSG_Fl_ACKNOWLEDGE  message  onto  the  response  buffer,  with  the 
acknowledgement  code  set  to  the  new  2-D  lut  value. 

The  function  always  returns  0. 
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Called  By:  fl_process_messages  (through  *FG_message_table) 


Routines  Called:  gsp_ioctl_read 

gsp_ioctl_write 

gsp_write 

m^_push 


Parameters: 


MSG_FO_FINAL_LUT_SWITCH  *message_P 
UNS_4  *buffer_P 


Returns:  0 


2.18.10  fO_mode_select.c 

The  fD_mode_select  function  processes  the  MSG_FO_MODE_SELECT  message.  This 
message  is  used  to  put  the  desired  resolution  and  panel  orientation  into  effect.  The  message 
is  sent  by  mpvideo_set_mode  to  load  the  default  mode  when  the  MPV  is  initialized,  and 
later  to  change  the  mode  if  the  Simulation  Host  sends  a  MSG_SUBSYS_MODE  message. 
The  message  can  also  be  generated  through  Gossip  by  selecting  the  6  ("MODE_SELECT") 
option  from  the  gos_mpvio  menu. 

This  message  is  supported  only  with  the  Value-Added  MPV  board  (revision  5). 

The  function  call  is  fO_mode_select(niessage_P,  buffer_P),  where: 

message  P  is  a  pointer  to  the  MSG_FO_MODE_SELECT  message 
buffer _P  is  a  pointer  to  the  buffer  to  be  used  for  the  response  message 

fO_mode_select  does  the  following: 


If  FG_mpv_type  is  0  (older  MPV  board): 

-  Pushes  a  MSG_Fl_ACKNOWLEDGE  message  onto  the  response  buffer 
with  the  acknowledgement  code  set  to  OxFFFF  (error). 

If  FG_mpv_type  is  1  (Value-Added  MPV  board): 

-  Retrieves  the  new  mode,  orientation,  resolution  i  and  j,  and  offset  i  and  j 
from  the  message. 

-  Puts  the  data  into  the  mode_select_data  structure. 

-  Calls  gsp_ioctl_read  to  read  the  GSP  host  control  word. 

-  Calls  gsp_ioctl_WTite  to  modify  the  host  control  word  to  set  the  data  strobe 
bit  on;  this  signals  the  GSP  that  I/O  is  required. 

-  Determines  the  MPV  buffer  base  address  from  the  host  control  word. 

-  Calls  gsp_ioctl_write  to  set  the  host  control  word  for  write  mode. 

-  Calls  gsp_write  to  write  the  new  values  from  the  mode_select_data  structure 
into  MPV  memory. 

-  Calls  fl_pa_new_orientation  to  change  the  viewport's  orientation. 

-  Calls  fl_pa_new_resolution  to  change  the  viewport's  resolution. 

-  Pushes  a  MSG_Fl_ACKNOWLEDGE  message  onto  the  response  buffer, 
with  the  acknowledgement  code  set  to  the  2-D  lookup  table  value  written 
into  the  MPV  board's  configuration  register. 
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The  function  returns  the  status  received  from  mx2_push  if  successful.  It  returns  0  if  the 
mpv_type  is  0. 

Called  By:  fl_process_messages  (through  *FG_message_table) 


Routines  Called:  mx2_push 

gsp_ioctl_read 

gsp_ioctl_write 

gsp_write 

fl_pa_new_orientation 
f  1  _pa_new_resolution 


Parameters: 


MSG_FO_MODE_SELECT  *message_P 

UNS_4  *buffer_P 


Returns:  0 

status 


2.18.11  fO_mpv_init.c 

The  fO_mpv_init  function  processes  the  MSG_F0_MPV_INrr  message.  This  message  is 
used  to  initialize  the  MPV.  The  message  can  be  generated  through  Gossip  by  selecting  the 
7  ("MPVJNTT")  option  from  the  gos_mpvio  menu. 

The  function  call  is  fO_mpv_init(message_P,  buffer_P),  where: 

message  JP  is  a  pointer  to  the  MSG_F0_MPV_INIT  message 
bi0er_P  is  a  pointer  to  the  buffer  to  be  used  for  the  response  message 

This  function  is  not  currently  implemented.  It  always  returns  0. 


Called  By: 


fl_process_messages  (through  *FG_message_table) 


Routines  CziUed:  none 


*message_P 

*buffer_P 


Returns:  0 


Parameters:  UNS_4 

UNS_4 


2.18.12  f0_mp  v_lut_ty  pe_request.c 

The  fD_mpv_lut_type_request  function  processes  the  MSG_FO_MPV_LUT_TYPE_- 
REQUEST  message.  This  message  is  used  to  determine  the  MPV's  board  type  and 
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whether  or  not  the  board  is  capable  of  accepting  downloaded  final  (2-D)  lookup  tables. 

The  function  returns  the  data  in  a  MSG_F1_MPV_LUT_TYPE  message. 

The  MSG_FO_MPV_LUT_TYPE_REQUEST  message  is  sent  by  mpvideo_boot  when  the 
system  is  initialized.  The  message  can  also  be  generated  through  Gossip  by  selecting  the  8 
("MPV_LIJT_TYPE_REQ")  option  from  the  gos_mpvio  menu. 

The  function  call  is  fO_mpvJut_type_request(message_P,  buffer_P),  where; 

message_P  is  a  pointer  to  the  MSG_FO_MPV_LUT_TYPE_REQUEST  message 
bi^er_P  is  a  pointer  to  the  buffer  to  be  used  for  the  response  message 

fO_mpv_lut_type_request  does  the  following; 

•  Gets  the  MPV  type  from  the  FG_mpv_type  global  variable  (l=Value- Added  MPV 
board,  0=older  MPV  board). 

•  Gets  the  final  lookup  table  type  from  the  FG_fmal_lut_type  global  variable  (l=final 
lookup  table  can  be  downloaded,  0=final  lookup  table  is  in  PROM). 

•  Pushes  a  MSG_F1_MPV_LUT_TYPE  message  containing  the  above  parameters 
onto  the  response  buffer. 

The  function  returns  the  status  received  from  mx2_push. 


Called  By; 


fl_process_messages  (through  *FG_message_table) 


Routines  Called;  mx2_push 


Parameters; 

UNS  4 

*message_P 

UNS_4 

*buffer_P 

Returns; 

status 

2.18.13  fO_mpv_peek.c 

The  fO_mpv_peek  function  processes  the  MSG_FO_MPV_PEEK  message.  This  message 
is  used  to  read  data  from  GSP  memory.  The  message  specifies  the  starting  address  and  the 
number  of  bytes  to  read.  The  data  is  returned  in  a  MSG_Fl_MPV_MEMORY  message. 

The  MSG_FO_MPV_PEEK  message  can  be  generated  through  Gossip  by  selecting  the  9 
("MPV_PEEK")  option  from  the  gos_mpvio  menu. 

The  function  call  is  fO_mpv_peek(message_P,  buffer_P),  where; 

message  P  is  a  pointer  to  the  MSG_FO_MPV_PEEK  message 
bi^er  P  is  a  pointer  to  the  buffer  to  be  used  for  the  response  message 

fO_mpv_peek  does  the  following; 
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•  Converts  the  byte  count  specified  in  the  message  to  a  half-word  count  (maximum 
256  half-words,  for  512  bytes). 

•  (Halls  gsp_ioctl_write  to  set  the  GSP  host  control  word  for  read  mode. 

•  Calls  gsp_read  to  read  the  specified  amount  of  data  from  GSP  memory,  starting  at 
the  specified  address. 

•  Pushes  a  MSG_Fl_MPV_MEMORY  message  with  the  data  read  from  the  GSP 
onto  the  response  buffer. 

The  function  always  returns  0. 


(Hailed  By:  fl_process_messages  (through  *FG_message_table) 


Routines  Called:  gsp_ioctl_write 

gsp_read 
mx2_push 


Parameters:  MSG_F0_MPV_PEEK  *message_P 

UNS_4  *buffer_P 


Returns:  0 


2.18.14  fO_mpv_poke.c 

The  fD_mpv_poke  function  processes  the  MSG_FO_MPV_POKE  message.  This  message 
is  used  to  write  one  32-bit  value  to  GSP  memory.  The  message  specifies  the  starting 
address  and  the  data  to  be  written.  The  message  can  be  generated  through  Gossip  by 
selecting  the  A  ("MPV_POKE")  option  from  Ae  gos_mpvio  menu. 

The  function  call  is  fO_mpv_poke(message_P,  buffer_P),  where: 

message  P  is  a  pointer  to  the  MSG_FO_MPV_POKE  message 
bi4fer_P  is  a  pointer  to  Ae  buffer  to  be  used  for  the  response  message 

f0_mpv_poke  does  the  following: 

•  Pushes  a  MSG_Fl_ACKNOWLEDGE  message  onto  the  response  buffer,  with  the 
acknowledgement  code  set  to  0  (success). 

•  Calls  gsp_ioctl_write  to  set  Ae  CJSP  host  control  word  for  write  mode. 

•  Calls  gsp_write  to  write  Ae  data  from  the  message  to  the  specified  location. 

The  function  returns  Ae  status  received  from  mx2_push. 


Called  By:  fl_process_messages  (through  *FG_message_table) 


Routines  Called: 


gsp_ioctl_write 

gsp_write 

mx2_push 
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Parameters: 


Returns; 


MSG_FO_MPV_POKE 
UNS  4 


status 


*message_P 
*  buffer  P 


2.18.15  f0_mpv_pokel6.c 

The  f0_mpv_pokcl6  function  processes  the  MSG_FO_MPV_POKE16  message.  This 
message  is  used  to  write  one  16-bit  value  to  GSP  memory.  The  message  specifies  the 
starting  address  and  the  data  to  be  written.  The  message  can  be  generated  through  Gossip 
by  selecting  the  M  ("MPV  POKE16")  option  from  the  gos_mpvio  menu. 

The  function  call  is  fO_mpv_pokel6(message_P,  buffer_P),  where: 

message _P  is  a  pointer  to  the  MSG_FO_MPV_POKE16  message 
bi^fer  P  is  a  pointer  to  the  buffer  to  be  used  for  the  response  message 

f0_mpv_pokel6  does  the  following: 

•  Pushes  a  MSG_Fl_ACKNOWLEDGE  message  onto  the  response  buffer,  with  the 
acknowledgement  code  set  to  0  (success). 

•  Calls  gsp_write  to  write  the  data  from  the  message  to  the  specified  location. 

The  function  returns  the  status  received  from  mx2_push. 


Called  By: 


Routines  Called: 


Parameters: 


Returns: 


f  l_process_messages  (through  *FG_message_table) 


gsp_write 

mx2_push 


MSG_FO_MPV_POKE 
UNS  4 


status 


*message_P 
♦buffer  P 


2.18.16  fO_mpv_reset.c 

The  fO_mpv_reset  function  processes  the  MSG_FO_MPV_RESET  message.  This  message 
is  used  to  reset  the  MPV  board.  The  message  is  sent  by  mpvideo_boot  when  the  system  is 
initialized  if  the  MPV  board  is  detected  to  be  a  Value-Added  MPV.  The  message  can  also 
be  generated  through  Gossip  by  selecting  the  B  ("MPV_RESET")  option  from  the 
gos_mpvio  menu. 

The  function  call  is  fO_mpv_reset(message_P,  buffer  ?),  where: 
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message  P  is  a  pointer  to  the  MSG_FO_MPV_RESET  message 
biffer  P  is  a  pointer  to  the  buffer  to  be  used  for  the  response  message 

fl)_mpv_reset  does  the  following: 


•  Calls  gsp_reset  to  reset  the  MPV  board. 

•  Sets  nmi_set_flag  to  0  (this  indicates  that  the  GSP  is  not  running). 

•  Pushes  a  MSG_Fl_ACKNOWLEDGE  reply  message  onto  the  response  buffer, 
with  the  acknowledgement  code  set  to  0  (success). 

The  function  returns  the  status  received  from  mx2_j)ush. 


Called  By:  fl_process_messages  (through  *FG_message_table) 


Routines  Called:  gsp_reset 

mx2_push 


Parameters:  UNS_4 

UNS_4 


*message_P 

*buffer_P 


Returns:  status 


2.18.17  f0_mpv_task_control.c 


The  fO_mpv_task_control  function  processes  the  MSG_FO_MPV_TASK_CONTROL 
message.  This  message  is  used  to  start  or  stop  the  MPV  task.  The  message  can  be 
generated  through  Gossip  by  selecting  the  C  ("MPV_TASK_CTL")  option  from  the 
gos_mpvio  menu. 

The  function  call  is  fO_mpv_task_control(message_P,  buffer_P),  where: 


message  P  is  a  pointer  to  the  MSG_FO_MPV_TASK_CONTROL  message 
biffer_P  is  a  pointer  to  the  buffer  to  be  used  for  the  response  message 


This  function  is  not  currently  implemented.  It  always  returns  0. 


Called  By:  fl_process_messages  (through  *FG_message_table) 


Routines  Called:  none 


Parameters:  UNS_4 

UNS_4 


*message_P 

*buffer_P 


Returns: 


0 


686 


BBN  Systems  and  Technologies 


GTIOO  RTSW  CSCI 


2.18.18  fO_mpv_test.c 

The  fO_mpv_test  function  processes  the  MSG_FO_MPV_TEST  message.  This  message  is 
used  to  request  that  the  Force  task  perform  MPV/Force  interface  tests  and  report  the  results. 
The  message  can  be  generated  through  Gossip  by  selecting  the  D  ("MPV_TEST")  option 
from  the  gos_mpvio  menu. 

The  function  call  is  fO_mpv_test(message_P,  buffer_P),  where: 

message_P  is  a  pointer  to  the  MSG.  FO_MPV_TEST  message 
biffer  P  is  a  pointer  to  the  buffer  to  be  used  for  the  response  message 

This  function  is  not  currently  implemented.  It  always  returns  0. 


Called  By: 


fl_process_messages  (through  *FG_message_table) 


Routines  Called:  none 


*message_P 

*buffer_P 


Returns:  0 


Parameters:  UNS_4 

UNS_4 


2.18.19  fO_mpv_write.c 

The  fO_mpv_write  function  processes  the  MSG_FO_MPV_WRITE  message.  This 
message  is  used  to  write  up  to  512  bytes  of  data  to  GSP  memory.  The  message  specifies 
the  data  to  be  written  and  the  starting  destination  address.  The  message  can  be  generated 
through  Gossip  by  selecting  the  E  ("MPV_WRITE")  option  from  the  gos_mpvio  menu. 

The  function  call  is  fO_mpv_write(message_P,  buffer_P),  where: 

message _P  is  a  pointer  to  the  MSG_FO_MPV_WRITE  message 
bi0er_P  is  a  pointer  to  the  buffer  to  be  used  for  the  response  message 

fO_mpv_write  does  the  following: 

•  Converts  the  byte  count  in  the  message  to  a  half-word  count. 

•  Calls  gsp_ioctl_write  to  set  the  GSP  host  control  word  for  write  mode. 

•  Calls  gsp_write  to  write  the  data  from  the  message  to  the  specified  address  in  GSP 
memory. 

•  Pushes  a  MSG_Fl_ACKNOWLEDGE  message  onto  the  response  buffer,  with  the 
acknowledgement  code  set  to  0  (success). 

The  function  always  returns  0. 
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Called  By:  f l_process_messages  (through  *FG_message_table) 


Routines  Called:  gsp_ioctl_write 

gsp_write 

mx2_push 


Parameters:  MSG_FO_MPV_WRiTE  *message_P 

UNS_4  *buffer_P 


Returns:  0 


2.18.20  f0_pass_on.c 

The  fD_pass_on  function  processes  the  MSG_FO_PASS_ON  message.  This  message  is 
sent  when  the  Simulation  Host  sends  messages  that  are  to  be  forwarded  to  an  imbedded 
subsystem.  Currently,  the  only  subsystem  Aat  receives  pass_on  messages  is  the  2-D 
processor  task.  The  message  is  used  to  update  2-D  overlay  components  (stored  in  GSP 
memory)  during  runtime. 

The  MSG_FO_PASS_ON  message  is  not  currently  used.  For  real-time  PASS_ON 
messages,  the  msg_pass_on  function  (in  the  Message  Processing  CSC)  puts  the  message 
data  in  a  buffer  and  the  Force  task  writes  it  to  GSP  memory.  The  MSG_FO_PASS_ON 
message  cannot  be  generated  through  Gossip  either,  as  the  F  ("PASS_ON")  option  on  the 
gos_mpvio  menu  is  not  cuirendy  implemented. 

The  function  call  is  fO_pass_on(message_P,  buffer_P),  where: 

message  P  is  a  pointer  to  the  MSG_FO_PASS_ON  message 
bi^er  P  is  a  pointer  to  the  buffer  to  be  used  for  the  response  message 

fD_pass_on  does  the  following: 

•  Reads  and  saves  the  GSP  host  control  word. 

•  Calls  gsp_ioctl_write  to  modify  the  host  conU'ol  word  to  set  the  data  strobe  bit  on; 
this  signals  the  GSP  that  I/O  is  required. 

•  Gets  the  MPV  buffer  base  address  from  the  control  word. 

•  Calls  gsp_ioctl_write  to  set  the  host  control  word  for  write  mode. 

•  Calls  gsp_write  to  write  the  new  data  to  GSP  memory. 

•  Pushes  a  MSG_Fl_ACKNOWLEDGE  message  onto  the  response  buffer,  with  the 
acknowledgement  code  set  to  0  (success). 

•  Calls  gsp_ioctl_write  to  restore  the  original  control  word,  turning  the  data  strobe  bit 
off. 

The  function  always  returns  0. 


Called  By:  fl_process_messages  (through  *FG_message_table) 


Routines  Called:  gsp_ioctl_read 
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gsp_ioctl_write 

gsp_write 

m^_push 


Parameters;  MSG_FO_PASS_ON 

UNS_4 


♦message_P 

*buffer_P 


Returns:  0 


2.18.21  fO_pixeI__depth_request.c 

The  fO_pixel_depth_requcst  function  processes  the  MSG_FO_PIXEL_DEPTH_REQUEST 
message.  This  message  is  used  to  obtain  a  depth  value  for  a  specified  pixel  location.  The 
message  is  sent  by  mpvideo_laser_requestjrange  when  the  Simulation  Host  sends  a 
MSG_LASER_R£QIJEST_RANGE  message  for  a  TX  backend.  The  message  can  also  be 
generated  through  Gossip  by  selecting  the  G  ("PIXEL_DEPTH_REQ")  option  from  the 
gos_mpvio  menu. 

fO_pixel_depth_request  takes  the  data  from  the  MSG_FO_PIXEL_DEPTH_REQUEST 
message  and  puts  it  into  several  arrays  that  are  used  by  fO_trigger  to  download  the  request 
to  the  MPV. 


The  function  call  is  fO_pixeI_depth_request(message_P,  buffer_P),  where: 

message _P  is  a  pointer  to  the  MSG_FO_PIXEL_DEPTH_REQlJEST  message 
bifferJP  is  a  pointer  to  the  buffer  to  be  used  for  the  response  message 

fO_pixel_depth_request  does  the  following: 


•  Gets  the  channel  number,  pixel  location  (i  j),  and  range  id  from  the  message. 

•  If  the  channel  number  is  greater  than  1,  returns  0  and  terminates. 

•  Calls  fl_pa_fb_offset  to  get  the  pixel  location’s  frame  buffer  address  offset. 

•  Sets  the  channel's  element  in  the  FG_pixel_addr[]  array  to  the  pixel's  GSP  address. 
fD_trigger  uses  this  value  when  sending  the  request  to  the  MPV. 

•  Sets  the  channel's  element  in  the  FG_pixel_id[]  array  to  the  range  id  from  the 
message.  fO_trigger  uses  this  value  when  sending  the  request  to  the; MPV. 

•  Sets  the  channel's  element  in  the  FG_pixel_depth_flagD  array  to  TRUE.  This 
prompts  ft)_trigger  to  read  the  depth  data  returned  from  the  hffV  and  generate  a 
MSG_F1_PIXEL_DEPTH_RETURN  message. 

•  Pushes  a  MSG_F1_PIXEL_ADDR  message  onto  the  response  buffer. 

•  Sets  the  channel's  element  in  the  FG_new_pixel_req_flag[]  array  to  4.  This  tells 
fD_trigger  that  there  is  a  depth  request  to  send  to  the  MPV. 

•  Sets  the  FG_pixel_depth_message  flag  to  TRUE.  This  tells  gsp_io  that  pixel 
locations  have  been  set. 


The  function  always  returns  0. 


Called  By:  f  l_process_messages  (through  *FG_message_table) 
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Routines  Called:  fl_pa_fb_offset 

nix2_push 


Parameters:  MSG_FO_PIXEL_DEPTH_REQUEST  *message_P 

UNS_4  *buffer_P 


Returns:  0 


2.18.22  fO_query.c 

The  fO_query.c  CSU  contains  the  function  used  to  process  the  MSG_FO_QUERY 
message.  It  also  contains  various  functions  used  to  manipulate  character  strings.  The 
functions  in  this  CSU  are; 

•  fO_queTy 

•  strcpy 

•  strcat 

•  strlen 


2.18.22.1  fO_query 

The  fO_query  function  processes  the  MSG_FO_QUERY  message.  This  message  is  used  to 
transfer  Gossip  data  to  and  request  general  information  from  the  Force  task.  The  message 
can  be  generated  through  Gossip  by  selecting  the  I  ("QUERY")  option  from  the  gos_mpvio 
menu.  The  Gossip  user  specifies  the  query  code  and  text. 

The  function  call  is  fO  query(message  P),  where  message_P  is  a  pointer  to  the 
MSG_FO_QUERY  message. 

fO_query  does  the  following; 

•  Selects  a  predefined  string  based  on  the  query  code  in  the  message. 

•  Copies  the  string. 

•  Concatenates  the  string  and  the  text  provided  in  the  message. 

•  Puts  the  concatenated  string  in  the  reply  message. 

•  Pushes  a  MSG_F1_TEXT  message  onto  the  force_reply  buffer. 

The  function  always  returns  1. 


dialled  By:  fl4jrocess_messages  (through  *FG_message_table) 


Routines  dialled:  mx2_push 

strcat 
strcpy 


Parameters:  MSG_FO_QUERY  *message_P 
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Returns:  1 

2.18.22.2  strcpy 

The  strqjy  function  copies  one  string  to  another. 

The  function  call  is  strcpyfstringl,  string2),  where: 


string!  is  the  destination  string 
stringl  is  the  source  string 

Called  By: 

fO_query 

Routines  Called: 

none 

Parameters: 

char 

char 

Returns: 

none 

2.18.22.3  strcat 

The  strcat  routine  concatenates  a  string  onto  the  end  of  another  string. 
The  function  call  is  strcatfstringl,  string2),  where: 
string!  is  the  first  string 

string2  is  the  string  to  be  added  to  the  end  of  string! 

The  concatenated  string  is  stored  in  string!. 


Called  By: 

fO_query 

Routines  Called: 

strlen 

Parameters: 

char 

char 

stringl 

string2 


stringl 

string! 


Returns: 


none 
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2.18.22.4  strlen 

The  strlen  function  determines  the  length  of  a  given  string. 

The  function  call  is  strlen(string),  where  string  is  a  pointer  to  the  string.  The  string 
length  is  returned  as  index. 

Called  By:  strcat 

Routines  Called:  none 


Parameters:  char 


♦string 


Returns:  index 


2.18.23  fO_set_display.c 

The  fO_set_display  function  processes  the  MSG_FO_SET_DISPLAY  message.  This 
message  is  used  to  timi  the  video  channels  driven  by  the  MPV  board  on  and  off.  The 
message  is  sent  by  mpvideo_set_video  at  the  beginning  of  a  simulation  (to  turn  all  channels 
on)  and  at  the  end  of  a  simulation  (to  turn  all  channels  off)-  It  is  also  sent  during  a 
simulation  if  the  Simulation  Host  sends  a  MSG_VIEWPORT_UPDATE  message.  The 
message  can  also  be  generated  through  Gossip  by  selecting  the  H  ("SET_DISPLAY") 
option  from  the  gos_mpvio  menu. 

The  function  call  is  fO_set_dispIay(message_P,  buffer_P),  where: 

message  P  is  a  pointer  to  the  MSG_FO_SET_DISPLAY  message 
bi0er_P  is  a  pointer  to  the  buffer  to  be  used  for  the  response  message 

fO_set_display  does  the  following: 

*  Calls  gsp_ioctl_write  to  set  the  GSP  host  control  word  for  write  mode. 

•  If  the  message  specifies  MPV_VIDEO_ON: 

Sets  the  mpv_video_code  to  ON. 

-  Calls  gsp_write  to  write  the  mpv_video_code  to  the  video  control  address. 

♦  If  the  message  specifies  MPV_VIDEO_OFF: 

-  Sets  the  mpv_video_code  to  OFF. 

-  Calls  gsp_write  to  write  the  mpv_video_code  to  the  video  control  address. 

•  Pushes  a  MSG_Fl_ACKNOWLEDGE  message  onto  the  response  buffer,  with  the 
acknowledgement  code  set  to  the  mpv_video_code. 

The  function  always  returns  0. 


Called  By:  fl_process_messages  (through  *FG_message_table) 
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Routines  Called:  gsp_ioctl_write 

gsp_write 
mx2_push 


Parameters:  MSG_FO_SET_DISPLAY  *message_P 

UNS_4  *buffer_P 


Returns:  0 


2.18.24  fO_trigger.c 

The  fo_trigger  function  processes  the  MSG_FO_TRIGGER  message.  This  message 
triggers  the  MPV  VO  to  communicate  direcdy  with  the  MPV  board  to  process  all  requests 
queued  during  the  preceding  frame.  The  function  returns  a  MSG_F1_PIXEL_DEPTH 
message  for  each  channel  for  which  laser  processing  has  been  requested.  It  also  returns  a 
MSG_Fl_MPV_IOCr  message  if  an  illegal  opcode  trap  is  detected  on  the  MPV. 

The  MSG_FO_TRIGGER  message  is  sent  by  mpvideo_send_req  every  frame,  after  all  of 
the  frame's  messages  have  been  processed  by  the  real-time  software.  The  message  can 
also  be  generated  through  Gossip  by  selecting  the  J  ("TRIGGER")  option  from  the 
gos_mpvio  menu. 

The  MPV  locations  for  each  channel's  pixel  depth  request  and  return  data  arc  specified  in 
terms  of  their  offset  from  the  MPV  board's  base  address.  The  offsets  are  defined  in  the 
mpv_mdef.h  file. 

The  function  call  is  fO_trigger(message_P,  buffer_P),  where: 

message  P  is  a  pointer  to  the  MSG_FO_TRIGGER  message 
bi0'er_P  is  a  pointer  to  the  buffer  to  be  used  for  the  response  message 

fO_trigger  does  the  following: 

•  Calls  gsp_ioctl_read  to  read  the  GSP  host  control  word. 

•  Calls  gsp_ioctl_write  to  modify  the  host  control  word  to  set  the  data  strobe  bit  on; 
this  signals  the  GSP  that  I/O  is  required. 

•  Determines  the  MPV  buffer  base  address  from  the  host  control  word. 

•  Calls  gsp_ioctl_write  to  set  the  host  control  word  for  read  mode. 

•  If  FG_pixeLdepth_flag[0]  is  TRUE,  indicating  that  channel  0  has  a  laser  depth 
request  pending: 

-  Sets  the  channel  number  to  0. 

-  Calls  gsp_read  to  read  the  pixel  depth  for  channel  0  Gocated  at  the  MPV's 
base  address  plus  the  offset  specified  by  PIXEL_DEPTH_A_OFF). 

-  CMs  gsp_read  to  read  the  range  id  for  this  request  (located  at  the  h^V's 
base  address  plus  the  offset  specified  by  PIXEL_ID_A_OFF). 

-  Pushes  a  MSG_F1_PIXEL_DEPTH_RETURN  message  for  channel  0  onto 
the  response  buffer. 

•  If  FG_pixeLdepth_flag[  1]  is  TRUE,  indicating  that  channel  1  has  a  laser  depth 
request  pending: 

-  Sets  the  channel  number  to  1. 
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-  Calls  gsp_read  to  read  the  pixel  depth  for  channel  1  Gocated  at  the  MPV's 
base  aitoess  plus  the  offset  specified  by  PIXEL_DEPTH_B_OFF). 

-  Calls  gsp_read  to  read  the  range  id  for  ^s  request  Gocated  at  the  MPV's 
base  address  plus  the  offset  specified  by  PIXEL_ID_B_OFF). 

-  Pushes  a  MSG_F1_PIXEL_DEPTH_RETURN  message  for  channel  1  onto 
the  response  buffer. 

•  Calls  gsp_ioctl_write  to  set  the  host  control  word  for  write  mode. 

•  If  FG_new_pixel_req_flag[0]  is  greater  than  0  Gndicating  that  channel  0  has  a  new 
pixel  depth  request  message  to  send  to  the  MPV;  fO_pixel_depth_request  sets  this 
value  to  4): 

-  D^ements  the  value  in  FG_new_pixel_req_flag[0]. 

-  Calls  gsp_write  to  write  the  pixel  address  to  the  MPV  Gocated  at  the  MPV's 
based  address  plus  the  offset  in  PIXEL_REQUEST_A_OFF). 

-  Calls  gsp_write  to  write  the  pixel  id  to  the  MPV  (at  the  MPV's  base  address 
plus  the  offset  in  PIXEL_ID_A_OFF). 

•  If  FG_new_pixel_re<Lflag[l]  is  greater  than  0  (indicating  that  channel  1  has  a  new 
pixel  depth  request  message  to  send  to  the  MPV;  fO_pixel_depth_request  sets  this 
value  to  4); 

-  Decrements  the  value  in  FG_new_pixel_req_flag[  1  ] . 

-  Calls  gsp_write  to  write  the  pixel  address  to  the  MPV  (located  at  the  MPV's 
based  address  plus  the  offset  in  PIXEL_REQUEST_B_OFF). 

Calls  gsp_write  to  write  the  pixel  id  to  the  MPV  (at  the  MPV's  base  address 
plus  the  offset  in  PIXEL_ID_B_OFF). 

•  Calls  gsp_ioctl_write  to  set  the  host  control  word  for  read  mode. 

•  Clalls  gsp_read  to  check  for  any  illegal  opcodes  from  the  GSP. 

•  If  any  opcode  errors  were  found,  pushes  a  MSG_Fl_MPV_IOCT  onto  the 
response  buffer. 

The  function  returns  the  status  received  from  mx2_push. 


Called  By:  fl_process_messages  (through  *FG_message_table) 

Routines  Called:  gsp_ioctl_read 

gsp_ioctl_write 

gsp_read 

gsp_write 

mx2_push 


Parameters:  UNS_4 

UNS_4 


Returns:  status 


2.18.25  fO_unknown.c 

Tlie  fO_unknown  function  is  called  if  an  unknown  message  type  is  received  from  the  real¬ 
time  software.  The  function  does  no  processing. 

The  function  call  is  fO_unknown(message_P,  buffer_P),  where: 


*message_P 

*buffer_P 
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message  J*  is  a  pointer  to  the  unknown  message 

buffer _P  is  a  pointer  to  the  buffer  to  be  used  for  the  response  message 

The  function  always  returns  0. 


Called  By:  f  l_process_messages  (through  *FG_message_table) 


Routines  Called:  none 


*message_P 

*buffer_P 


Returns:  0 


Parameters:  UNS_4 

UNS_4 


2.18.26  fl_force_init.c 

The  fl_force_init  function  initializes  the  Force  task  upon  initial  (cold)  start. 

The  function  call  is  fl_force_init().  The  function  does  the  following: 

•  Calls  excep_init  to  initialize  the  exception  vector  table. 

•  Initializes  the  Force  interface  mailbox. 

•  Initializes  the  Force  control  register  in  the  Force  interface  mailbox  for  GSP  I/O  (as 
opposed  to  test  mode  in  which  the  GSP  is  not  actually  read  or  written  to). 

•  Initializes  the  sync  re^sters  in  the  Force  interface  mailbox. 

•  Calls  init_ports  to  initialize  the  Force-GSP  interface. 

•  Calls  fl_pa_init  to  initialize  the  pixel  address  object . 

•  Calls  gsp_read  to  determine  the  MPV  resolution  (from  the  GSP  configuration 
register). 

•  C^s  f  l_pa_new_resolution  to  set  the  MPV  resolution  (RES_640x480  or 
RES_320x240). 

•  Initializes  the  FG_final_lut_type  global  variable  to  MPV_NO_LUT_DWNLD  (2-D 
lookup  table  is  not  downloadable  because  table  is  contained  in  PROM). 

•  Initializes  the  FG_pixel_depth_message  global  variable  to  FALSE  (no  locations 
have  been  set  for  laser  range  processing). 

•  Sets  the  FG_mpv_type  global  variable  l«sed  on  the  setting  of  the  MPV  DIP  switch: 
1  for  Value-Added  MPV  boards,  0  for  older  boards. 

•  If  the  MPV  type  is  1  (Value-Added  MPV),  sets  FG_final_lut_type  to 
MPV_LIJT_DWNLD  (2-D  lookup  table  can  be  downloaded  to  the  MPV). 

•  Calls  f  l_setup_environment  to  set  up  the  Force  environment  variables  to  the  real¬ 
time  software. 

•  Calls  fl_initjump_table  to  initialize  the  array  used  to  call  the  appropriate  f0_* 
frinction  for  each  message  received  from  the  real-time  software. 


Called  By:  main 
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Routines  Called:  excep_imt 

fl_initjump_table 

fl_pa_init 

f  1  _pa_new_resolution 
f  1  _setup_environment 
gsp_read 
init_ports 


Parameters:  none 

Returns:  none 


2.18.27  fl_initjump_table.c 

The  f  l_initjump_table  function  initializes  the  Force  message  processing  jump  table 
(FG_message_table).  This  array  contains  one  entry  for  each  valid  message  tj^e  that  can  be 
received  from  the  real-time  software.  Each  entry  in  the  array  contains  the  name  of  the  f0_* 
function  to  call  for  that  message  type.  The  f  l_process_messages  function  indexes  into 
FG_message_table[]  to  call  the  appropriate  f0_*  function  for  each  message  it  receives. 

The  function  call  is  fl_init_jump_table().  The  function  first  initializes  all  255  entries  to 
point  to  the  fO_unkno\^  function,  then  modifies  the  entries  for  all  valid  message  types. 

The  index  number  assigned  to  each  valid  message  type  is  defined  in  the  mpvideo_msg.h 
file. 


Called  By:  f l_force_init 


Routines  Called:  none 


Parameters:  none 


Returns:  none 


2.18.28  fl_pixel_address.c 

The  functions  in  the  fl_pixel_address.c  CSU  are  used  to  return  the  frame  buffer  address 
offset  for  a  pven  pixel  location.  The  CSU  contains  a  separate  function  for  each  resolution 
and  orientation.  These  functions  are: 


•  fl_pa_init 

•  fl_pa_new_orientation 

•  fl_pa_new_resolution 

•  fl_pa_fb_offset 

•  fl_pa_640x480_v 

•  fl_pa_320x240_v 
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•  fl_pa_640x256_v 

•  fl_pa_640x240_v 

•  fl_pa_640x480_h 

•  fl_pa_320x240_h 

•  f l_pa_640x256  h 

•  fl_pa_640x240_h 


The  pa_FP_table  array  contains  one  element  for  each  supported  orientation^soluiion. 
Each  element  contains  the  name  of  the  fl_pa_*_v  or  f  l_pa_*_h  function  used  to  process 
frame  buffer  address  requests  for  viewports  with  the  specified  attributes. 


The  fl_pa_*_v  and  fl_pa_*_h  functions  are  called  via  the  *pixel_address_FP  function 
pointer.  This  pointer  is  set  by  indexing  into  pa_FP_table[]  with  a  specified  orientation  and 
resolution. 


2.18.28.1  fl_pa_init 

The  f  l_pa_init  function  initializes  the  pa_FP_table  array  when  the  Force  board  is 
initialized.  pa_FP_tableG  contains  one  entry  for  each  supported  orientation/resolution 
combination.  Each  entry  contains  the  name  of  the  f  l_pa_*_v  or  fl_pa_*_h  function  that 
processes  frame  buffer  address  requests  for  viewports  with  that  orientation  and  resolution. 

The  function  call  is  fl_pa_init().  The  function  does  the  following; 

•  Defines  each  element  in  the  pa_FP_table  array. 

•  Sets  the  default  viewport  orientation  to  vertical. 

•  Sets  the  default  viewport  resolution  to  640  x  480. 

•  Sets  the  *pixel_address_FP  function  pointer  to  the  default  orientation  and 
resolution.  This  function  pointer  is  used  by  other  Force  functions  to  index  into  the 
pa_FP_table  for  a  given  orientation  and  resolution. 

The  function  always  returns  1. 


Called  By:  fl_force_init 


Routines  Called:  none 


Parameters:  none 

Returns:  1 


2.18.28.2  fl_pa_new_orientation 

The  f  l_pa_new_orientation  function  changes  the  orientation  of  a  viewport.  This  function 
is  called  to  load  the  default  orientation  when  the  MPV  is  initialized,  and  later  to  change  the 
orientation  if  the  Simulation  Host  sends  a  MSG_SUBSYS_MODE  message.  A  new 
orientation  can  also  be  specified  through  Gossip.  Orientation  changes  are  supported  only 
by  the  Value-Added  MPV  board. 
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The  function  call  is  fl_pa_new_orientatlon(new_orientation),  where 
new_orientaiion  is  ORIENT_VERTICAL  or  ORJENT_HORIZONTAL. 

fl_pa_new_orientation  does  the  following: 

•  Verifies  that  the  new  orientation  is  valid. 

•  Resets  the  *pixel_address_FP  function  pointer  to  reflect  the  new  orientation. 
The  function  returns  1  if  successful.  It  returns  0  if  the  new  orientation  is  invalid. 

Called  By:  fO_mode_select 

Routines  Called:  none 


Parameters:  HWORD  new_orientation 

Returns:  0 

1 


2.18.28.3  fl_pa_new_resolution 

The  fl_pa_new_resolution  function  changes  the  resolution  of  a  viewport.  This  function  is 
called  to  load  the  default  resolution  when  the  MPV  is  initialized,  and  later  to  change  the 
resolution  if  the  Simulation  Host  sends  a  MSG_SUBSYS_MODE  message.  A  new 
resolution  can  also  be  specified  through  Gossip.  Resolution  changes  are  supported  only  by 
the  Value-Added  MPV  board. 

The  function  call  is  fl_pa  new_r€solution(new_resolution),  where  new_resolution 
is  RES_640x480,  RLS_320x24O,  RES_640x256,  or  RES_640x240. 

fl_pa_new_resolution  does  the  following: 

•  Verifies  that  the  new  resolution  is  valid. 

•  Resets  the  *pixel_address_FP  function  pointer  to  reflect  the  new  resolution. 

The  function  returns  1  if  successful.  It  returns  0  if  the  new  resolution  is  invalid. 


Called  By:  f0_mode_select 

fl_force_init 


Routines  Called:  none 


Parameters:  HWORD 


new_resolution 
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Returns:  0 

1 


2.18.28.4  fl_pa_fb_offset 

The  fl_pa_fb_offset  function  finds  the  frame  buffer  address  offset  for  a  given  pixel 
location  on  a  specified  viewport.  This  function  is  called  to  process  laser  range  requests. 

The  function  call  is  fl_pa_fb_offset(plxeM,  pixel_j,  viewport),  where: 

pixel  i  is  the  horizontal  coordinate  of  the  pixel 
pixel  J  is  the  vertical  coordinate  of  the  pixel 
viewport  is  the  viewport  number  (0  or  1) 

fl_pa_fb_offset  uses  the  *pixel_address_FP  function  pointer  to  call  the  appropriate 
fl_pa_*_v  or  fl_pa_*_h  function  to  determine  the  pixel's  frame  buffer  address  offset.  It 
then  returns  this  value  as  fb_ojfset. 


Called  By: 

fO_pixel_depth_request 

gspjo 

Routines  Called: 

*pixel_address_FP 

Parameters; 

HWORD 

pixelj 

HWORD 

pixelj 

HWORD 

viewport 

Returns: 

fb_offset 

2.18.28.5  fl_pa_640x480_v 

The  fl_pa_640x480_v  function  returns  the  frame  buffer  address  offset  for  a  given  pixel 
location  for  viewports  with  640  x  480  resolution  and  vertical  panel  orientation. 

The  function  call  is  fl_pa_640x480_v(pixel_i,  pixel_j,  viewport),  where: 

pixel  i  is  the  horizontal  coordinate  of  the  pixel 
pixel  J  is  the  vertical  coordinate  of  the  pixel 
viewport  is  the  viewport  number  (always  0) 

fl_pa_640x480_v  does  the  following: 

•  Verifies  that  the  viewport  number  is  0  and  the  pixel  location  is  valid  (pixel_i  <  640 
and  pixel  J  <  480). 

•  Sets  the  panel  offset  (panel  starting  address)  based  on  the  specified  horizontal 
offset,  and  reduces  the  horizontal  offset  accordingly. 

•  Computes  the  total  offset  by  OR'ing  the  panel,  horizontal,  and  vertical  offsets. 
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The  function  returns  the  frame  buffer  address  offset  {gsp  total _ojf set)  if  successful.  It 


returns  0  if  the  viewport 

number  or  pixel  location  is  invalid. 

(Tailed  By: 

fl_pa_fb_offset 

(through  *pixel_address 

Routines  Called: 

none 

Parameters: 

HWORD 

pixelj 

HWORD 

pixelj 

HWORD 

viewport 

Returns: 

0 

gsp_total_offset 

2.18.28.6  fl_pa_320x240_v 

The  fl_pa_320x240_v  function  returns  the  frame  buffer  address  offset  for  a  given  pixel 
location  for  viewports  with  320  x  240  resolution  and  vertical  panel  orientation. 

The  function  call  is  fl_pa_320x240_v(pixe!_i,  pixelj,  viewport),  where: 

pixelj  is  the  horizontal  coordinate  of  the  pixel 
pixel  J  is  the  vertical  coordinate  of  the  pixel 
viewport  is  the  viewport  number  (0  or  1) 

fl_pa_320x240_v  does  the  following: 

•  Verifies  that  the  viewport  number  is  either  0  or  1  and  the  pixel  location  is  valid 
(pixelj  <  320  and  pixelj  <  240). 

•  Sets  the  panel  offset  (panel  starting  address)  based  on  the  specified  horizontal 
offset,  and  reduces  the  horizontal  offset  accordingly. 

•  Modifies  the  panel  offset  if  working  with  viewport  1. 

•  Computes  the  total  offset  by  OR'ing  the  panel,  horizontal,  and  vertical  offsets. 

The  function  returns  the  frame  buffer  address  offset  (gsp  total  offset)  if  successful.  It 
returns  0  if  the  viewport  number  or  pixel  location  is  invalid. 


Called  By: 


fl_pa_fb_offset  (through  *pixel_address_FP) 


Routines  Called:  none 


Parameters:  HWORD 

HWORD 

HWORD 


pixelj 

pixelj 

viewport 
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Returns:  0 

gsp_total_offset 


2.18.28.7  fl_pa_640x256_v 

The  fl_pa_640x256_v  function  returns  the  frame  buffer  address  for  a  given  pixel  location 
for  viewports  with  640  x  256  resolution  and  vertical  panel  orientation. 

The  function  call  is  fl_pa_640x256_v(plxel_i,  pixel J,  viewport),  where: 

pixel  i  is  the  horizontal  coordinate  of  the  pixel 
pixel  J  is  the  vertical  coordinate  of  the  pixel 
viewport  is  the  viewport  number  (0  or  1) 

fl_pa_640x256_v  does  the  following: 

•  Verifies  that  the  viewport  number  is  either  0  or  1  and  the  pixel  location  is  valid 
(pixel_i  <  640  and  pixelj  <  256). 

•  Sets  the  panel  offset  (panel  starting  address)  based  on  the  specified  horizontal 
offset,  and  reduces  the  horizontal  offset  accordingly. 

•  Modifies  the  panel  offset  if  working  with  viewport  1 . 

•  Computes  the  total  offset  by  OR'ing  the  panel,  horizontal,  and  vertical  offsets. 


The  function  returns  the  frame  buffer  address  offset  (^sp  total _ojf set)  if  successful 
returns  0  if  the  viewport  number  or  pixel  location  is  invalid. 

Called  By: 

fl_pa_fb_offset 

(through  *pixel_address_FP) 

Routines  Called: 

none 

Parameters: 

HWORD 

HWORD 

HWORD 

pixelj 

pixelj 

viewport 

Returns: 

0 

gsp_total_offset 

2.18.28.8  fl_pa_640x240_v 

The  fl_pa_640x240_v  function  returns  the  frame  buffer  address  for  a  given  pixel  location 
for  viewports  with  640  x  240  resolution  and  vertical  orientation. 

The  function  call  is  fl_pa_640x240_v(pixel_i,  pixel_j,  viewport),  where: 

pixel  i  is  the  horizontal  coordinate  of  the  pixel 
pixel  J  is  the  vertical  coordinate  of  the  pixel 
viewport  is  the  viewport  number  (always  0) 
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fl_pa_640x240_v  does  the  following: 

•  Verifies  that  the  viewport  number  is  0  and  the  pixel  location  is  valid  (pixel_i  <  640 
and  pixel_j  <  240). 

•  Sets  the  panel  offset  (panel  starting  address)  based  on  the  specified  horizontal 
offset,  and  reduces  the  horizontal  offset  accordingly. 

•  Computes  the  total  offset  by  OR'ing  the  panel,  horizontal,  and  vertical  offsets. 

The  function  returns  the  frame  buffer  address  offset  (gsp  total  offset)  if  successful.  It 
returns  0  if  the  viewport  number  or  pixel  location  is  invalid. 


Called  By: 

fl_pa_fb_offset 

(through  *pixel_address 

Routines  Called: 

none 

Parameters: 

HWORD 

pixel_i 

HWORD 

pixelj 

HWORD 

viewport 

Returns: 

0 

gsp_total_offset 

2.18.28.9  fl_pa_640x480_h 

The  fl_pa_640x480_h  function  returns  the  frame  buffer  address  for  a  given  pixel  location 
for  viewports  with  640  x  480  resolution  and  horizontal  panel  orientation. 

The  function  call  is  fl_pa_640x480_h(pixel_i,  pixel_j,  viewport),  where: 

pixel  i  is  the  horizontal  coordinate  of  the  pixel 
pixel  J  is  the  vertical  coordinate  of  the  pixel 
viewport  is  the  viewport  number  (always  0) 

fl_pa_640x480_h  does  the  following: 

•  Verifies  that  the  viewport  number  is  0  and  the  pixel  location  is  valid  (pixel_i  <  640 
and  pixel  J  <  480). 

•  Sets  the  panel  offset  (panel  starting  address)  based  on  the  specified  vertical  offset, 
and  reduces  the  vertical  offset  accordingly. 

•  Computes  the  total  offset  by  OR'ing  the  panel,  horizontal,  and  vertical  offsets. 

The  function  returns  the  frame  buffer  address  offset  {gsp  total  offset)  if  successful.  It 
returns  0  if  the  viewport  number  or  pixel  location  is  invalid. 


CaUed  By:  fl_pa_fb_offset  (through  *pixel_address_FP) 


Routines  Called:  none 
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pixelj 

pixelj 

viewport 


Returns:  0 

gsp_total_offset 


Parameters:  HWORD 

HWORD 
HWORD 


2.18.28.10  fl_pa_320x240_h 

The  f  l_pa_320x240_h  function  returns  the  frame  buffer  address  for  a  given  pixel  location 
for  viewports  with  320  x  240  resolution  and  horizontal  panel  orientation. 

The  function  call  is  fl_pa_320x240_h(pixel_i,  pixel_j,  viewport),  where: 

pixel  j  is  the  horizontal  coordinate  of  the  pixel 
pixel  J  is  the  vertical  coordinate  of  the  pixel 
viewport  is  the  viewport  number  (0  or  1) 

fl_pa_320x240_h  does  the  following: 

•  Verifies  that  the  viewport  number  is  either  0  or  1  and  the  pixel  location  is  valid 
(pixelj  <  320  and  pixelj  <  240). 

•  Sets  the  panel  offset  (panel  starting  address)  based  on  the  specified  vertical  offset, 
and  reduces  the  vertical  offset  accordingly. 

•  Modifies  the  panel  offset  if  working  with  viewport  1 . 

•  Computes  the  totzd  offset  by  OR'ing  the  panel,  horizontal,  and  vertical  offsets. 

The  function  returns  the  frame  buffer  address  offset  igsp  total _offset)  if  successful.  It 
returns  0  if  the  viewport  number  or  pixel  location  is  invalid. 


Called  By: 

fl_pa_fb_offset 

(through  *pixel_address. 

Routines  Called: 

none 

Parameters: 

HWORD 

pixelj 

HWORD 

pixelj 

HWORD 

viewport 

Returns: 

0 

gsp_total_offset 

2.18.28.11  fl_pa_640x256_h 

The  fl_pa_640x256_h  function  returns  the  frame  buffer  address  for  a  given  pixel  location 
for  viewports  with  640  x  256  resolution  and  horizontal  panel  orientation. 
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The  function  call  is  fl_pa_640x256_h(pixelj,  pixelj,  viewport),  where: 

pixelj  is  the  horizontal  coordinate  of  the  pixel 
pixel  J  is  the  vertical  coordinate  of  the  pixel 
viewport  is  the  viewport  number  (0  or  1) 

fl_pa_640x256_h  does  the  following: 

•  Verifies  that  the  viewport  number  is  either  0  or  1  and  the  pixel  location  is  valid 
(pixel_i  <  640  and  pixelj  <  256). 

•  Sets  the  panel  offset  (panel  starting  address)  based  on  the  specified  vertical  offset, 
and  reduces  the  vertical  offset  accordingly. 

•  Modifies  the  panel  offset  if  working  with  viewport  1. 

•  Computes  the  total  offset  by  OR'ing  the  panel,  horizontal,  and  vertical  offsets. 

The  function  returns  the  frame  buffer  address  offset  {gsp  total  offset)  if  successful.  It 


returns  0  if  the  viewport 

number  or  pixel  location  is  invalid. 

CaUed  By: 

fl_pa_fb_offset 

(through  *pixel_address. 

Routines  Called: 

none 

Parameters: 

HWORD 

pixelj 

HWORD 

pixelj 

HWORD 

viewport 

Returns: 

0 

gsp_total_offset 

2.18.28.12  fl_pa_640x240_h 

The  fl_pa_640x240_h  function  returns  the  frame  buffer  address  for  a  given  pixel  location 
for  viewports  with  640  x  240  resolution  and  horizontal  orientation. 

The  function  call  is  fl_pa_640x240_h(pixel_i,  pixel _j,  viewport),  where: 

pixel  j  is  the  horizontal  coordinate  of  the  pixel 
pixel  J  is  the  vertical  coordinate  of  the  pixel 
viewport  is  the  viewport  number  (always  0) 

fl_pa_640x240_h  does  the  following: 

•  Verifies  that  the  viewport  number  is  0  and  the  pixel  location  is  valid  (pixelj  <  640 
and  pixelj  <  240). 

•  Sets  the  panel  offset  (panel  starting  address)  based  on  the  specified  vertical  offset, 
and  reduces  the  vertical  offset  accordingly. 

•  Computes  the  total  offset  by  OR’ing  the  panel,  horizontal,  and  vertical  offsets. 


704 


BBN  Systems  and  Technologies 


GTIOO  RTSW  CSCI 


The  function  returns  the  frame  buffer  address  offset  (gsp_total_qffset)  if  successful.  It 
returns  0  if  the  viewport  number  or  pixel  location  is  invalid. 


dialled  By: 

fl_pa_fb_offset 

(through  *pixel_address_FP) 

Routines  dialled: 

none 

Parameters: 

HWORD 

HWORD 

HWORD 

pixel_i 

pixelj 

viewport 

Returns: 

0 

gsp_total_offset 

2.18.29  fl_process_messages.c 


The  fl_process_messages  function  handles  the  messages  that  are  sent  to  Force  from  the 
real-time  software  and  Gossip.  It  previews  each  message  in  both  incoming  message 
buffers  (to_force  and  force_query),  and  calls  the  appropriate  f0_*  function  to  process  it. 


The  function  call  is  fl_process_messages().  The  function  does  the  following: 


Calls  mx2_peek  to  preview  the  top  message  in  the  to_force  buffer  (used  for 
messages  from  the  real-time  software). 

If  a  message  is  found  (indicated  by  a  status  of  MX_MESSAGE_PRE VIEWED 
from  mx2_push): 

-  Calls  se_clock  to  read  the  Force  timers  and  store  the  values. 

-  Turns  on  the  Force  lights. 

-  Indexes  into  the  *FG_message_table  with  the  message  code;  this  invokes 
the  appropriate  f0_*  routine  to  process  the  message.  Specifies 
FG_from_force_buf  as  the  response  buffer  to  be  used  by  the  f0_*  routine. 
Calls  mx2_skip  to  remove  the  processed  message  from  the  to_force  buffer. 

-  Turns  off  the  Force  lights. 

-  Calls  se_clock  to  read  the  Force  timers  and  store  the  values. 

Calls  mx2_peek  to  preview  the  top  message  in  the  force_query  buffer  (used  for 
messages  from  Gossip). 

If  a  message  is  found  (indicated  by  a  status  of  MX_MESSAGE_PRE VIEWED 
from  mx2_push): 

-  Calls  se_clock  to  read  the  Force  timers  and  store  the  values. 

-  Turns  on  the  Force  lights. 

-  Indexes  into  the  *FG_message_table  with  the  message  code;  this  invokes 
the  appropriate  f0_*  routine  to  process  the  message.  Specifies 
FG_force_reply_buf  as  the  response  buffer  to  be  used  by  the  f0_*  routine. 

-  Calls  mx2_sldp  to  remove  the  processed  message  from  the  force_query 
buffer. 

-  Turns  off  the  Force  lights. 

-  Calls  se_clock  to  read  the  Force  timers  and  store  the  values. 
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Called  By:  poll_ready 


Routines  Called:  *FG_inessage_table 

tnx2_peek 
inx2_skip 
se_clock 


Parameters:  none 

Returns:  none 


2.18.30  fl_setup_environinent.c 

The  fl_setup_environment  function  sets  up  the  environment  variables  for  the  Force 
software.  This  function  is  called  when  the  Force  board  is  initialized. 

The  function  call  is  fl_setup_environment().  The  function  does  the  following: 

•  Sets  up  the  global  variables  for  the  message  buffers. 

•  Sets  up  the  Force  environment  variables  for  the  Force-CIG  type,  the  software 
version,  and  the  size  of  each  message  buffer. 

•  Sets  the  force_started  variable  to  TRUE;  this  tells  the  real-time  software  that  the 
environment  setup  is  complete. 

•  Calls  mx2_open  to  open  Ae  Force-RTSW  and  Force-Gossip  message  buffers. 
The  function  always  returns  TRUE. 


Called  By:  fl_force_init 


Routines  Called:  mx2_open 


Parameters:  none 

Returns:  TRUE 


2.18.31  force.asm 

The  force.asm  CSU  contains  a  group  of  suln-outines  used  by  the  Force  functions  to  read 
from  and  write  to  the  GSP.  These  functions  are  the  following: 

•  inii_ports 

•  gsp_write 

•  gsp_read 

•  gsp_ioctl_read 

•  gsp_ioctl_write 
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•  gsp_reset 

This  module  is  written  in  assembly  language  to  obtain  optimal  performance  from  the 
68230-to-GSP  interface. 


2.18.31.1  init_ports 

The  init_pOTts  function  is  called  at  start-up  to  initialize  the  Force-GSP  interface.  The 
function  call  is  init_ports(). 


Called  By: 

fl_force_init 

Routines  Called: 

none 

Parameters: 

none 

Returns: 

none 

2.18.31.2  gsp_write 

The  gsp_write  function  writes  a  block  of  data  from  the  Force  board's  memory  down  to  the 
GSP.  This  function  is  used  to  download  subsystem  mode  data,  color  lookup  tables,  2-D 
overlay  data,  and  pixel  addresses  and  ids  for  laser  range  processing. 

The  function  call  is  gsp_write(number_hwords,  data_buffer,  gsp_address), 
where: 

number  Jiwords  is  the  number  of  words  to  be  written  to  the  GSP 
data  buffer  is  the  location  of  the  data  in  Force  memory 
gsp  address  is  the  address  to  write  to 


Called  By:  data_type 

f0_3dlut_download 

f0_3dlut_switch 

fO_alllui_switch 

fO_final_lut_download 

fO_final_lut_switch 

fO_mode_select 

fO_mpv_poke 

f0_mpv_pokel6 

fO_mpv_write 

fO_pass_on 

fD_set_display 

fD_trigger 

gsp_io 

main 

nmi_type 
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poll_ready 

test_gsp 

Routines  Called: 

none 

Parameters: 

HWORD 

number_hwords 

HWORD 

♦data_buffer 

WORD 

gsp_address 

Returns: 

none 

2.18.31.3  gsp_read 

The  gsp_read  function  reads  a  block  of  data  from  the  GSP  into  Force  memory.  This 
function  is  used  to  read  color  lookup  tables,  pixel  depths  and  ids,  and  the  MPV's 
resolution.  It  is  also  used  to  check  for  illegal  opcode  errors  and  to  verify  writes  to  the 
GSP. 

The  function  call  is  gsp_read  (number_hwords,  data_buffer,  gsp_address), 
where: 

number  hwords  is  the  number  of  words  to  be  read  from  the  GSP 
data  buffer  is  the  location  of  the  data  in  Force  memory 
gsp_address  is  the  address  to  read  from 


Called  By: 

data_type 

fD_3dlut_download 

fO_final_lut_download 

fO_mpv_peek 

fD_trigger 

fl_force_init 

gspjo 

main 

test_gsp 

Routines  Called: 

none 

Parameters: 

HWORD 

number_hwords 

HWORD 

*data_buffer 

WORD 

gsp_address 

Returns: 

none 
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2.18.31.4  gsp_ioctl_read 

The  gsp_ioctI_read  function  reads  the  control  word  from  the  GSP  host  interface  control 
register.  This  function  is  used  to  read  the  control  word  before  modifying  it  to  set  the  data 
strobe  bit  on  to  signal  the  GSP  of  required  I/O. 

The  function  call  is  gsp  ioctl_read().  The  function  returns  the  control  word  as  an 
integer  (half  word  =16  Sits). 


Called  By: 

fO_alllut_switch 

fO_final_lut_switch 

fO_mode_select 

fO_pass_on 

fD_trigger 

gspjo 

main 

Routines  Called: 

none 

Parameters: 

none 

Returns: 

controLdata 

2.18.31.5  gsp_ioctl_write 

The  gsp_ioctl_write  function  writes  the  control  word  to  the  GSP  host  interface  control 
register.  This  function  is  used  to  set  the  control  word  for  read  or  write  mode,  or  to  set  the 
data  strobe  bit  on  to  signal  the  GSP  of  required  I/O. 

The  function  call  is  gsp_ioctl_write(control_data),  where  control  data  is  the  control 
word  to  be  written.  ~ 


Called  By:  data_type 

f0_3dlut_download 

f0_3dlut_switch 

fO_alllut_switch 

fO_final_lut_switch 

fO_mode_select 

fD_mpv_peek 

fO_mpv_poke 

fO_mpv_write 

fO_pass_on 

fD_set_display 

fO_trigger 

gspjo 

main 


709 


BBN  Systems  and  Technologies 


GTIOO  RTSW  CSCI 


nmi_type 

poU_ready 

test_gsp 

Routines  CaUed; 

none 

Parameters: 

int 

controLdata 

Returns: 

none 

2.18.31.6  gsp_reset 

The  gsp_reset  function  resets  the  Value-Added  MPV  board.  This  function  is  called  when 
the  system  is  initialized  if  a  Value-Added  MPV  is  detected.  The  function  can  also  be 
invoked  through  Gossip  by  selecting  the  B  ("MPV_RESET")  option  on  the  gos_mpvio 
menu. 

The  function  call  is  gsp_reset(). 


CaUed  By:  fO_mpv_reset 


Routines  Called;  none 


Parameters:  none 

Returns;  none 


2.18.32  forcetask.c 


The  forcetask.c  CSU  contains  the  main  Force  Processing  task  and  various  functions  related 
to  timing  The  functions  in  this  CSU  are: 


•  main 

•  compare_buffers 

•  restart_clock 

•  red_clock 

•  se_clock 


2.18.32.1  main 

The  main  function  processes  commands  placed  in  the  Force  firont-end  conffol  register  by 
the  real-time  software  and  Gossip.  This  task  is  loaded  and  started  by  the  bootforce 
function  in  the  MPV  Interface  CSC. 
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The  function  call  is  inain().  main  does  the  following: 

•  Calls  fl_force_init  to  initialize  the  Force  control  registers,  various  parameters,  and 
the  Force-GSP  interface. 

•  Turns  off  the  Force  lights. 

•  Calls  poll_ready  to  re^  the  command  in  the  FE_CONTROL  register. 

•  Processes  each  message,  calling  other  Force  functions  as  appropriate. 

•  Clears  the  ready  bit  in  the  FE_CONTROL  register. 

The  following  table  describes  the  processing  performed  by  main  for  each  command  sent  by 
linkup  or  gos_mpvio.  The  first  column  identifies  the  command,  preceded  by  the  upper 
byte  of  the  value  in  the  FE_CONTROL  register  (this  is  the  value  returned  by  poll_ready). 
TTie  second  column  describes  the  purpose  of  the  command  (in  italics),  then  shows  the 
major  steps  performed  by  main  to  process  that  command. 


Message 

Processing  by  main 

0  SUBSYS_MAIL_SEND 

Process  mail,  pixel  depth  ir^ormation,  and  pass  on  2-D 
components  to/from  the  GSP. 

Makes  sure  nmi_set_flag  is  1  (triggers  GSP  I/O 
processing);  turns  Force  lights  on;  calls  se_clock;  calls 
gsp_io;  calls  se_clock;  turns  Force  lights  off. 

1  SUBSYS  READ  START. 
SUBSYS  WRITE  START, 
SUBSYS  READ  MORE, 
SUBSYS_WRITE_MORE 

Send  data  to  or  receive  data  from  the  GSP. 

Turns  Force  lights  on;  calls  se_clock;  calls  (lata_typc; 
calls  se_clock;  turns  Force  lights  off. 

2  SUBSYS_NMI_START 

Start  the  GSP  task. 

Calls  nmi_type. 

3  SUBSYS_TEST_MEM 

Test  the  ability  to  read  fromJwrite  to  GSP  memory. 

Calls  lest_gsp;  if  any  errors  are  returned,  sets  Force 
control  register. 

6  SUBSYS_STOP 

Halt  the  GSP  task. 

Calls  gspJoctl_wriie  to  set  halt  mode;  sets 
nmi_set_flag  to  0. 

10  SUBSYS_READ_HCTRL 

Read  the  control  register. 

Calls  gsp_ioctl_read;  puts  response  in  daia_buf_in. 

11  SUBSYS_WRITE_HCTRL 

Write  to  the  control  register. 

Calls  gspJoctl_write  to  write  data  from  data_buf_out. 

12  SUBSYS_READ_HDATA 

Read  data  from  GSP  memory. 

Calls  g^_read  to  read  data  into  data_buf_in- 

13  SUBSYS_WRITE_HDATA 

1 

Write  data  to  GSP  memory. 

Calls  gspJoctl_write  to  set  write  mode;  calls  gsp_write 
to  write  data  from  data_buf_out;  calls  gsp_ioctl_write  to 
set  read  nrode;  calls  gsp_read  and  compare_buffers  to 
verify  data  was  written  correctly. 

15 

Reset  Force  clock. 

Calls  restart_clock. 
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Routines  Called: 

compare_buffers 

data_type 

fl_force_init 

gspjo 

gsp_ioctl_rcad 

gsp_ioctl_write 

gsp_read 

gsp_write 

nmi_type 

poll_ready 

red_clock 

rcstart_clock 

se_clock 

test_gsp 

Parameters: 

none 

Returns: 

none 

2.18.32.2  compare_buffers 

The  compare_buffers  function  is  a  boolean  function  that  compares  the  contents  of  two 
buffers.  This  function  is  used  to  verify  '.vrites  to  GSP  memory. 

The  function  call  is  compare_buffer(hword_count,  ptrl,  ptr2),  where: 

hwordjcount  is  the  length  of  the  data  to  be  compared 
ptrl  and  ptrl  are  pointers  to  the  buffers  to  be  compared 

The  function  returns  TRUE  if  the  buffer  contents  are  equal,  and  FALSE  if  they  are  not. 


Called  By: 

data_type 

main 

Routines  Called: 

none 

Parameters: 

HWORD 

hword_count 

HWORD 

*ptrl 

HWORD 

*ptr2 

Returns: 

1  (TRUE) 

0  (FALSE) 
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2.18.32.3  restart_clock 

The  restart_clock  function  resets  the  Force  clocks  to  0. 
The  function  call  is  restart  ciockQ- 


Called  By; 


mam 


Routines  Called:  none 


Parameters: 


none 


Returns:  none 


2.18.32.4  red  clock 


Tne  red_cIock  function  reads  the  Force  clocks  and  places  the  values  read  into  the  locations 
passed  in  the  call. 


The  function  call  is  red_clock(timervaI, 


pittimer),  where: 


timerval  is  a  pointer  to  real-time  clock 
pittimer  is  a  pointer  to  pit  clock 


Called  By; 

se_clock 

Routines  Called: 

none 

Parameters: 

UNS  2 

*timerval 

UNS_4 

*pittimer 

Returns: 

none 

2.18.32.5  seclock 

The  se_clock  function  triggers  the  Force  clock  to  be  read  and  the  values  placed  into  a  timing 
array.  The  timing  array,  timit[],  is  index  by  a  code  supplied  by  the  calling  function.  Each 
element  in  the  array  contains  the  real-time  and  pit  timer  values  returned  by  red_clock. 


The  function  call  is  se_clock(code),  where  code  is  the  index  (0-51 1)  into  the  timit[] 
array.  The  function  does  the  following: 
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•  Sets  the  code  to  0  if  it  is  greater  then  511. 

•  Calls  red_clock  to  read  the  Force  timers  and  place  the  values  in  the  element 
specified  by  code  in  the  timit[]  array. 


Called  By:  fl_process_messages 

main 

poll_ready 


Routines  Called:  red_clock 


Parameters:  UNS_2 


code 


Returns:  none 


2.18.33  gsp_io.c 

The  gspjo  function  processes  mail  and  pixel  depth  data  to  and  from  the  GSP.  This 
function  is  called  when  the  command  in  the  Force  ffont-end  control  register  is 
SUBSYS_MAIL_SEND. 

The  function  call  is  gsp_io().  gsp_io  does  the  following: 

•  Calls  gsp_ioctl_read  to  read  the  control  word. 

•  Calls  gsp_ioctl_write  to  modify  the  host  control  word  to  set  the  data  strobe  bit  on; 
this  signals  the  GSP  that  I/O  is  required. 

•  Determines  the  buffer  id  and  base  address  from  the  host  control  word. 

•  If  the  FG_debug_flag  is  on,  pushes  a  MSG_Fl_ACKNOWLEDGE  message  onto 
the  force_reply  buffer  to  return  status. 

•  Gets  the  data  buffer  size  from  SUB_DATA_BUFF. 

•  Calls  gsp_ioctl_write  to  set  the  host  control  word  for  write  mode. 

•  Calls  gsp_write  to  write  the  SIM-to-2D  data  to  2D  memory. 

•  If  FG_pixel_depth_message  is  FALSE  (no  pixel  locations  selected  for  laser  range 
processing): 

Cdls  fl_pa_fb_offset  to  get  the  GSP  address  offsets  of  the  default  pixel 
location  for  each  channel. 

-  Calls  gsp_write  to  write  the  pixel  address  offsets  to  GSP  memory. 

•  Calls  gsp_ioctl_write  to  set  the  host  control  word  for  read  mode. 

•  Calls  gsp_read  to  put  the  data  from  the  2D-to-SIM  buffer  into  Force  memory. 

•  Calls  gsp_ioctl_write  to  set  the  host  control  word  for  read  nxxle. 

•  Calls  gsp_read  to  put  the  pixel  depth  return  data  for  both  channels  into  Force 
memory. 

•  Calls  gsp_ioctl_write  to  restore  the  original  control  word,  turning  the  data  strobe  bit 
off. 

•  Clears  the  ready  bit  in  the  front-end  control  register  to  signal  the  real-time  software 
that  it  is  done. 


Called  By:  main 
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Routines  Called:  fl_pa_fb_offset 

gsp_ioctl_read 

gsp_ioctl_write 

gsp_read 

gsp_write 

mx2_push 


Parameters:  none 

Returns:  none 


2.18.34  inx2_hword.c 

The  functions  in  the  mx2_hword.c  CSU  manage  the  half-word  message  buffers  used  for 
the  interface  between  Force  Processing  and  the  real-time  software.  These  functions  are: 

•  mx2_open 

•  mx2_push 

•  mx2_peek 

•  mx2_skip 

•  mx2_error 

•  mx2_hwcopy 

These  functions  are  also  present  in  the  Real-Time  Processing  CSC  (see  section  2.13).  The 
Routines  Called  and  Called  By  lists  in  this  section  do  not  include  any  real-time  software 
(e.g.,  MPV  Interface)  functions.  Similarly,  the  Routines  Called  and  Called  By  lists  in 
section  2.13  do  not  include  any  Force  Processing  functions. 

The  mx2_hword.c  file  also  contains  the  typedef  for  the  message  buffer  (MX2_DEV1CE) 
and  message  header  (MESSAGE_HEADER)  structures. 


2.18.34.1  mx2_open 

The  mx2_open  function  initializes  a  half-word  message  buffer  with  a  specified  size. 

The  function  call  is  mx2_open(dev_P,  device_size),  where: 

dev  P  is  a  pointer  to  the  message  buffer 
device  size  is  the  size  of  the  message  buffer 

The  function  always  returns  MX_DEVICE_OPENED. 


Called  By:  fl_setup_environment 

Routines  Called:  scjock 

sc_unlock 
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Parameters;  MX2_DEVICE 

INT_4 


Returns:  MX_DEVICE_OPENED 


2.18.34.2  inx2_push 

The  mx2_push  function  pushes  a  message  onto  a  message  buffer. 

The  function  call  is  mx2_push(dev_P,  sou rce_ad dress,  message_code, 
message_size),  where:  ~  ~ 

dev  P  is  a  pointer  to  the  message  buffer 
source  address  is  the  address  of  the  message 
message  code  is  the  message  type  indicator 
message  size  is  the  size  of  the  message  in  bytes 

mx2_push  does  the  following; 

•  Checks  to  see  if  the  buffer  has  room  for  the  message. 

•  Calls  mx2_hwcopy  to  copy  the  message  to  the  buffer. 

The  function  returns  MX_MESSAGE_PUSHED  if  successful.  It  returns 
MX_DEVICE_FULL  if  the  message  buffer  is  already  full. 


*dev_P 

device_size 


Called  By:  f0_3dlut_download 

f0_3dlut_switch 
fO_alllut_switch 
fD_debug_di  sable 
fD_debug_enable 
fO_fmal_lut_download 
fD_final_lut_switch 
fD_mode_seIect 
fO_mpv_lut_type_request 
fO_mpv_peek 
fO_mpv_poke 
fD_mpv_pokel6 
fD_mpv_reset 
fO_mpv_write 
fO_pass_on 

fO_pixel_depth_request 

fO_query 

fD_set_display 

fD_trigger 

gsp_io 


Routines  Called:  mx2_hwcopy 

sc_lock 
sc_unlock 
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Parameters:  MX2_DEVICE  *dev_P 

WORD  source_address 

HWORD  message_code 

HWORD  message_size 


Returns:  MX_DEVICE_FULL 

MX_MESSAGE_PUSHED 


2.18.34.3  mx2_peek 

The  mx2_peek  function  previews  the  top  message  in  the  message  buffer  and  returns  a 
pointer  to  it 

The  function  call  is  mx2_peek(dev_P,  message  code,  message  size, 
message_addr),  where: 

devJP  is  a  pointer  to  the  message  buffer 
messagejcode  is  a  pointer  to  the  message  type  indicator 
message  size  is  a  pointer  to  the  message  size  in  bytes 
message  addr  is  a  pointer  to  the  message  address 

The  function  returns  MX_MESSAGE_PRE VIEWED  if  successful.  It  returns 
MX_DEVICE_EMPTY  if  the  message  buffer  contains  no  messages. 


Called  By:  fl_process_messages 


Routines  Called:  scjock 

sc  unlock 


Parameters:  MX2_DEVICE 

HWORD 
HWORD 
BYTE 


Returns:  MX_DEVICE_EMPTY 

MX_MESSAGE_PREVIEWED 


2.18.34.4  mx2_skip 

The  mx2_skip  function  skips  over  first  message  in  the  message  buffer.  The  skipped 
message  is  flushed  from  the  buffer  and  the  next  message  moves  to  the  head  of  the  queue. 

The  function  call  is  mx2_skip(dev_P),  where  dev  P  is  a  pointer  to  the  message  buffer. 


*dev_P 

*message_code 

*message_size 

**message_addr 
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The  function  returns  MX_MESSAGE_S  KIPPED  if  successful.  It  returns 
MX_DEVICE_EMPTY  if  the  message  buffer  contains  no  messages. 


Called  By: 


fl_process_messages 


Routines  Called:  sc_lock 

sc_unlock 


Parameters:  MX2_DEVICE  *dev_P 


Returns:  MX_MESSAGE_SKIPPED 

MX_DEVICE_EMPTY 


2.18.34.5  mx2_error 

The  mx2_error  function  returns  an  ASCII  translation  of  an  error  code,  for  output  to  the 
operator. 

The  function  call  is  nix2_error(status),  where  status  is  the  error  condition. 

This  function  is  not  currently  used. 

Called  By:  none 

Routines  Called:  none 


Parameters:  WORD  status 


Returns:  "DEVICE  CLOSED" 

"DEVICE  TABLE  FULL" 
"DEVICE  OPENED" 
"DEVICE  BUSY" 

"DEVICE  EMPTY" 
"DEVICE  FULL" 
"MESSAGE  PUSHED" 
"MESSAGE  POPPED" 
"MESSAGE  PREVIEWED" 
"MESSAGE  SKIPPED" 
"UNDEFINED  ERROR" 
"UNDEHNED  RETURN" 


2.18.34.6  mx2_hwcopy 

The  mx2_hwcopy  function  does  a  half-word  block  copy. 
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The  function  call  is  mx2_hwcopy(source_P,  destination  P,  byte_count),  where: 

source  JP  is  the  source  location 
destination  P  is  the  destination  location 
byte  count  is  the  number  of  bytes  to  be  copied 


Called  By: 

mx2_push 

Routines  Called: 

none 

Parameters: 

INT  2 

*source_P 

INT  2 

*destination_P 

INT_2 

byte_count 

Returns: 

none 

2.18.35  nmi^type.c 

The  nmi_type  function  starts  the  GSP  task.  This  function  is  called  if  the  command  in  the 
Force  ftont-end  control  register  is  SUBSYS_NMI_START. 

The  function  call  is  nmiJypeO.  The  function  does  the  following: 

•  Puts  the  GSP  start  address  into  a  data  buffer. 

•  Calls  gsp_ioctl_write  to  set  the  host  interface  control  word  to  write  mode. 

•  Calls  gsp_ymte  to  ymte  the  stan  address  into  the  NMI  vector  area  of  GSP  memory. 

•  Calls  gsp_ioctI_write  to  set  the  GSP  host  interface  control  register  to  flush  and  clear 
the  GSP  cache. 

•  Calls  gsp_ioctl_wnte  to  set  the  GSP  host  interface  control  register  to  start  the  GSP 
task. 

•  Sets  the  NMI  flag  for  other  routines  to  check  before  writing  to  the  control  register 

•  Clears  the  FE_CONTROL  ready  bit. 

The  NMI  (non-maskable  interrupt)  is  a  bit  in  the  GSP  host  interface  control  register. 


Called  By:  main 


Routines  CMed:  gsp_ioctl_write 

gsp_write 


Parameters:  none 


Returns:  none 
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2.18.36  poII_ready.c 

The  polLready  function  polls  the  ready  bit  in  the  Force  front-end  control  register  until  the 
bit  is  set.  (This  register  is  used  to  pass  messages  from  the  real-time  software  to  the  Force 
task.)  polLready  then  returns  the  upper  byte  of  the  value  in  the  control  register.  This  value 
identifies  the  command  to  be  perfom^. 

The  function  call  is  poII_ready().  The  function  does  the  following: 

•  Sets  up  the  address  for  the  fiont-end  control  register. 

•  Turns  the  Force  lights  on. 

•  Checks  the  control_change  variable  in  the  Force  mailbox  to  see  if  the  Simulation 
Host  has  specified  a  new  3-D  color  lookup  table.  If  yes: 

-  Calls  se_clock  to  read  and  store  the  Force  timer  values. 

-  Calls  gsp_ioctl_write  to  set  the  host  control  word  for  write  mode. 

-  Calls  gsp_write  to  notify  the  GSP  of  the  table  switch. 

-  Calls  se_clock  to  read  and  store  the  Force  timer  values. 

•  Checks  the  control_change  variable  in  the  Force  mailbox  to  see  if  the  Simulation 
Host  has  specified  a  new  2-D  (final)  lookup  table.  If  yes: 

-  Calls  se_clock  to  read  and  store  the  Force  timer  values. 

-  Calls  gsp_write  to  notify  the  GSP  of  the  table  switch. 

-  Calls  se_clock  to  read  and  store  the  Force  timer  values. 

•  Checks  the  req_control  variable  in  the  Force  mailbox  to  see  if  the  Simulation  Host 
has  specified  changes  to  the  video  control  registers.  If  yes: 

-  Calls  se_clock  to  read  and  store  the  Force  timer  values. 

-  Calls  gsp_ioctl_write  to  set  the  host  control  word  fcH-  write  mode. 

-  Calls  gsp_write  to  notify  the  GSP  of  the  new  control  values. 

-  Calls  se_clock  to  read  and  store  the  Force  timer  values. 

•  Turns  the  Force  lights  off. 

•  If  the  ready  bit  is  set: 

-  Turns  the  Force  lights  off. 

-  Calls  se_clock  to  read  and  store  the  Force  timer  values. 

Returns  the  upper  byte  of  the  front-end  control  register. 

•  Calls  fl_process_messages  to  process  the  messages  plac^  in  the  Force  message 
buffers  by  the  real-time  software. 

•  Turns  the  Force  lights  off. 

The  function  returns  the  upper  byte  of  the  value  in  the  Force  front-end  control  register. 


Called  By:  main 


Routines  Called:  fl_process_messages 

gsp_ioctl_write 
gsp_write 
se_clock 


Parameters:  none 
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Returns:  (*te_ctl  &  MSG_MASK) »  4 


2.18.37  testgsp.c 

The  test_gsp  function  writes  a  pattern  to  GSP  memory,  reads  it  back,  and  compares  the 
data.  This  fiinction  is  called  by  main  if  the  command  in  the  FE_CONTROL  register  is 
SUBSYS_TEST_MEM. 

The  function  call  is  test_gsp().  test_gsp  does  the  following: 

•  Writes  a  test  pattern  to  a  buffer  area. 

•  Calls  gsp_ioctl_write  to  set  the  host  control  register  for  write  mode. 

•  Calls  gsp_write  to  write  the  data  in  the  SUB_DATA_BUFF  buffer  to  GSP 
memory. 

•  Calls  gsp_ioctl_write  to  set  the  host  control  register  for  read  mode. 

•  Calls  gsp_read  to  read  GSP  memory  into  the  feTlJRN_DATA_BUFF  buffer. 

•  Compares  the  data  in  the  two  buffers. 

The  function  reports  the  number  of  errors  detected  as  err  count. 


Called  By:  main 


Routines  Called:  gsp_ioctl_write 

gsp_read 
gsp_write 


Parameters:  none 


Returns:  err  count 
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3  RESOURCE  UTILIZATION 


3.1  Disk  Space  Requirements 

The  total  amount  of  disk  space  required  to  house  the  object  files  for  all  of  the  CIG  real-time 
functions  is  «TBD»  bytes  (approximately  «TBD»  megabytes). 


3 . 2  Memory  Requirements 

The  system's  memory  requirements  vary  based  on  application-specific  parameters  and 
system  options.  In  genei^,  a  minimum  of  «TBD»  megabytes  of  CPU  memory  is 
required. 

A  minimum  of  «TBD»  megabytes  of  memory  is  required  for  active  area  memory. 
Additional  AAM  memory  is  required  for  databases  with  an  extended  viewing  range  (greater 
than  4000  meters). 
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APPENDIX  A.  SYSTEM  INCLUDE  FILES 

Include  files  define  data  structures  and  parameters  used  throughout  the  system.  Although 
many  include  files  are  used  exclusively  by  functions  in  one  area,  others  are  used  by 
multiple  CSCs.  For  easy  reference,  all  include  files  are  described  in  this  appendix,  in 
alphabetical  order.  Each  subsection  tide  identifies  the  full  path  name  of  the  file. 


A.l  /cig/include/backend.h 

The  backend.h  file  contains  the  typedefs  for  the  AAM  and  backend  object  structures.  It 
also  defines  the  maximum  number  of  backends. 

Included  By:  aa_init.c 

backend_color.c 

backendjaser.c 

backend_man.c 

backend_thermal  .c 

backend_video.c 

be_stubs.c 

cal.c 

esifa_man.c 
mpvideo_man.c 
msg_calibration_image  .c 


A.  2  /cig/include/bal_real_time,h 

The  bal_real_time.h  file  includes  the  following  real-time  software  header  files,  used  by 
Ballistics:  rt_definitions.h,  rt_types.h,  and  rt_macros.h. 

Included  By:  bO_*.c  (all  files) 

bx_*.c  (all  files) 
gos_bal_query 
mx_*.c  (all  fdes) 
shot_report.c 


A.  3  /cig/include/bal_struct.h 

The  bal_struct.h  file  defines  the  Ballistics  structures  for  chord  data,  trajectory  position, 
trajectory  data,  and  projected  data.  This  file  also  includes  standard.h  and  sim_cig_if  h 

Included  By:  real_timevpt.h 


A. 4  /cig/include/ballistics.h 

The  ballistics.h  file  includes  all  of  the  common  Ballistics  header  files: 

•  bx_defines.h 

•  bx_messages.h 

•  bx_rtdb_structs.h 

•  bx_structs.h 
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bx_macros.h 

bm_functions.h 

nix_defines.h 

slave  133_functions.h  (if  running  on  a  Slave  board) 


Included  By:  bO_*.c  (all  files) 

bx_*.c  (all  files) 
flea_decode_data.c 
gos_bal_query.c 
shot_report.c 


A.  5  /cig/include/bbnctype.h 

The  bbnctype.h  file  defines  character-testing  macros  (isalpha,  isdigit,  isascii,  etc.)  and 
character-conversion  macros  (tolower,  toupper,and  toascii). 

Included  By;  bbnctype.c 


A.  6  /cig/include/bm_functions.h 


The  bm_functions.h  file  declares  all  Ballistics  message  functions  (bO_bal_config, 
bO_database_info,  bO_add_traj_table,  etc.). 


Included  By: 


ballistics.h 
bxjnit.c 
bx  reset.c 


A. 7  /cig/include/bp_functions.h 

The  bp_functions.h  file  is  not  currently  used. 


A.  8  /cig/include/bx_defines.h 
The  bx_defines.h  file  defines  the  following: 


•  The  MALLOC  macro  (described  in  Appendix  B). 

•  The  maximum  number  of  bvol  types,  model  types,  AAM  partitions,  messages, 
static  vehicles,  rounds,  bvol  cache  entries,  polygon  cache  entries,  load  modules, 
vehicle  load  modules,  trajectories,  terrain  feedback  points,  and  terrain  feedback 
vehicles. 

•  DTP  data  transformation  commands. 

•  DTP  data  components  commands. 

•  DTP  data  traversal  commands. 

•  Database  effect  model  numbers. 


Included  By:  ballistics.h 
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A. 9 


/cig/include/bx_externs.h 


The  bx_extems.h  file  declares  external  variables  for  Ballistics,  including: 


•  Input  and  output  buffers. 

•  Global  (G_*)  variables. 

•  Temporary  variables  used  for  message  processing. 

Included  By:  bO_*.c  (all  files) 

bx_chord_intersect.c 

bx_compute_round.c 

bx_find_vehicle.c 

bx_functions.c 

bx_get_lm_data.c 

bx_init.c 

bx_model_int.c 

bx_probe.c 

bx_reset.c 

bx_tf_pack.c 

bx_trajectory.c 

gos_bal_query.c 


A.  10  /cig/inciude/bx_globaIs.h 


The  bx_globals.h  file  declares  variables  for  Ballistics,  including: 


•  Input  and  output  buffers. 

•  Global  (G_*)  variables. 

•  Temporary  variables  used  for  message  processing. 


Included  By:  bx_task 


A.  11  /cig/include/bx_macros.h 

The  bx_macros.h  file  defines  the  following  macros  used  by  various  functions  in  Ballistics: 

•  DELETE_ROUND 

•  DELETE_STAT_VEH 

•  FREE_LM_CACHE 

•  GET_CHORD_END 

•  GET_DB_POS 

•  GET_LB_FROM_LM 

•  NEW_ROUND 

•  NEW_STAT_VEH 


These  macros  are  described  in  Appendix  B. 
Included  By:  ballistics.h 
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A.  12  /cig/include/bx_messages.h 
The  bx_messages.h  file  contains  the  following: 

•  Declaration  of  the  maximum  message  size. 

•  Definitions  for  the  bal_board_type  ballistics  board  type)  variable 

•  Definitions  for  code  trace  bits. 

•  The  addresses  of  the  boards. 

•  Typedefs  for  all  simulation-to-Ballistics  (MSG_B0_*)  messages. 

•  Typedefs  for  all  Ballistics-to-simulation  (MSG_B  !_*)  messages. 

Included  By:  bal_routines.c 

ballistics.h 
config_ballistics.c 
db_mcc_setup.c 
download_bvols.c 
load_modules.c 
msg_proce  ss_round4  8  .c 
open_dbase.c 
open_ded.c 
rowcoLrd.c 
simulation.c 


A.  13  /cig/include/bx_rtdb_structs.h 

The  bx_rtdb_structs.h  file  defines  the  structure  of  the  real-time  database  for  Ballistics.  It 
includes  typedefs  for  the  following: 

•  Floating  bounding  volume  entry. 

•  Single- transform  model  structure. 

•  Show  effects  stamp  structure. 

•  Tank  structure. 

•  Database  directory  entry. 

•  Runtime  database  header. 

•  Fixed  bounding  volume  entry. 

•  Generic  load  module  directory  entry. 

•  Grid  components. 

•  Grid  locator  information. 

•  Load  module  header. 

•  Load  module  statistics  (generic  model,  unique  static,  and  terrain  grid  polygon 
count,  plus  total  bytes  per  load  module). 

•  Polygon  data  (info  word). 

•  Polygon  list  of  vertices  and  alpha  betas  for  texmring. 

This  file  also  defines  the  maximum  number  of  models  that  can  be  put  in  the  generic  module 
of  the  runtime  database,  the  maximum  number  of  stamps  possible  in  one  unique  static 
object  definition,  and  the  number  of  z  values  in  a  grid  component. 

Included  By:  ballistics.h 
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A.  14  /cig/include/bx_structs.h 

The  bx_structs.h  file  contains  structure  definitions  for  Ballistics.  It  includes  typedefs  for 
the  following; 

•  Load  module/grid  search  list. 

•  Static  vehicle. 

•  Bounding  volume  cache  entry. 

•  Terrain  and  object  polygon. 

•  Polygon  cache  entty. 

•  Lo^  module  cache  entry. 

•  Trajectory  table  entry. 

•  Trajectory  table. 

•  Point  data. 

•  Chord. 

•  Round  data. 

•  Terrain  comers. 

Included  By:  ballistics.h 


A.  15  /cig/include/cigsimio.h 

The  cigsimio.h  file  contains  the  structures  used  for  writing  messages  to  a  file  during 
runtime  (to  record  a  script  for  later  playback  or  to  display  messages  to  stdout).  This  file 
defines  the  message  structure  and  the  tag  records. 

Included  By:  cigsimio_obj.c 

flea_script.c 
host_if_debug.c 
print_msg.c 


A.  16  /cig/include/clouds.h 

The  clouds.h  file  defines  cloud  control  structures,  including  cloud  states  and  cloud  control 
blocks. 

Included  By;  flea.c 

gossip.c 

init_sim.c 

tnsg_cig_ctl.c 

msg_drll.c 

msg_end.c 

msg_pass_on.c 

msg_subsys_mode.c 

msg_vport.c 

rcal_time.h 

real_timevpt.h 

simulation.c 
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A.  17  /gt/include/ciparse.h 

The  clparse.h  file  is  used  to  parse  the  command  line  entered  to  start  up  the  system.  It 
defines  the  structure  used  to  define  each  valid  switch. 

Included  By:  bxl47_main.c 

loadmpv.c 

rtt.c 

rtt_iniLc 


A.  18  /cig/include/db_struct.h 

The  db_strucLh  file  defines  MAX_DB_PARTTTIONS  and  GMAL_S1ZE.  It  also  contains 
the  typedefs  for  the  database_pointers,  db_info,  and  lms_data  (load  module  specific  data) 
structures. 

This  file  includes  standard.h  and  model_struct.h. 

Included  By:  real_timevpt.h 


A.  19  /cig/incIude/def_alloc.h 

The  def_alloc.h  file  defines  DYNAMIC  as  0  and  SYSTEM  as  1. 

Included  By:  cig_config.c 

clouds.c 
flagoff.c 
gun_overlays.c 
init_free.c 
msg_end.c 
mtx_concat.c 
path.c 
path_init.c 
real_time.h 
vpt_set.c 


A. 20  /cig/include/def_intx_type.h 

The  def_mtx_type.h  file  defines  configuration  node  types  (MATRIX_NODE, 
BRANCH.NODE,  and  BRANCH_MTX_NODE)  and  matrix  types  (RTS3x3_TYPE, 
RTS4x3_TYPE,  ROT2xl_TYPE,  TRANSLATION,  SCALE,  ROTl_TYPE,  and 
ROT3_TYPE). 

Included  By:  encode_routines.c 

flea_bal_opts.c 
flea_init_cig_sw.c 
print_msg.c 
tick.c 

vpi_smict.h 
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A. 21  /cig/include/defines_2d.h 

The  defines_2d.h  file  contains  definitions  used  by  the  2-D  compiler,  including: 

•  All  2-D  database  commands  (N_*,  A_*,  and  B_*). 

•  Return  codes  (end  of  file,  too  many  errors,  invalid  window  number,  etc.). 

•  Color,  plane,  and  static/dynamic  commands. 

•  MPV  addresses  (base  component  pointers  and  base  program  area). 

•  MPV  default  screen  parameters  (e.g.,  dimensions  and  pitch). 

•  MPV  space  allocation. 

•  Array  sizes  (maximum  number  of  component  pointers,  windows,  component 
descriptions,  etc.). 

•  The  maximum  number  of  2-D  compiler  errors  allowed  before  the  compilation  is 
aborted. 

Included  By:  global_2d.h 

globfu-_2d.h 


A. 22  /cig/include/definitions.h 

The  definitions.h  file  defines  miscellaneous  constants  and  structures  used  by  the  real-time 
software.  It  includes: 

•  Various  definitions  used  for  by  Ballistics  to  parse  bounding  volume  structures  and 
repon  hits. 

•  Definitions  of  various  macros  (ABSVAL,  SET_OUT_BITS,  SET_OUT_M2BITS, 
XREAD,  XOPEN,  XCLOSE,  XLSEEK,  XWRITE,  AAREAD).  These  are 
described  in  Appendix  B. 

•  The  typedef  for  the  load  module/grid  search  list  structure. 

•  Pointers  for  messages  and  other  parameters. 

Included  By:  flea.c 

flea_bal_opts.c 

flea_simulate_vehicles.c 

global_init.c 

gossip.c 

host_drl  l_if.c 

host_mpv_if.c 

host_socket_if.c 

init_sim.c 

mpvideo_response.c 

nisg_cig_ctl.c 

msg_drll.c 

msg_cnd.c 

msg_laser,c 

msg_lt_state.c 

msg_pass_on.c 

msg_ppm.c 

msg_process_round4  8  .r 

msg_subsys_mode.c 

real_time.h 
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real_timevpt.h 

msg_vport.c 

rtt_init.c 

simulation.c 


A. 2 3  /cig/incIude/demo_struct.h 
The  demo_structh  file  specifies  the  following: 

•  Various  limits  for  Flea  exercises  (MAX_DEMO_MODELS,  MAX_HITS, 
MAX.COLLISIONS,  etc.). 

•  The  typedef  for  the  DEMOl  stmcture  used  for  Flea  demos  (model  rotation,  starting 
position,  spacing  between  models,  etc.). 

•  The  typ^efs  for  the  F_SIMIN  and  F_SIMOUT  structures,  used  to  exchange 
messages  with  the  real-time  software  during  a  Flea  exercise. 

•  The  ty^ef  for  the  POI  (point  of  interest)  structure. 

•  The  typedef  for  the  SIM_VEH_STRUCT  (simulated  vehicle)  structure. 

Included  By:  dynamic_demo.c 

encode_routines.c 
flea.c 

flea_agl_terrain_follow.c 

flea_agpt_locations.c 

flea_agpt_switches.c 

flea_bd_opts.c 

flea_db_traverse.c 

flea_decode_data.c 

flea_encode_data.c 

flea_init_cig_sw.c 

flea_ppm_obj.c 

flea_script.c 

flea_simulate_vehicles.c 

flea_switches.c 

flea_update_pos.c 

flea_veh_control.c 

get_sio_data.c 

model_demo.c 

tick.c 

tick_ppm.c 

tick_script.c 

update_2d.c 

update_agpt_2d.c 


A. 24  /cig/include/dgi_stdc.h 

The  dgi_stdc.h  file  helps  make  the  code  compiler-independent  (avoiding  differences  in 
storage  allocation  caused  by  differences  in  C  compilers)  by  defining  basic  data  types,  as 
follows: 
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Storage  Allocated 

C  Language 

Independent  Data  Type 

18  bit  char 

char 

char 

16  bit  signed  integer 

short 

INT_2 

32  bit  signed  integer 

int 

INT_4 

8  bit  unsigned  integer 

unsigned  char 

BYTE,  BCX)LEAN 

16  bit  unsigned  integer 

unsigned  short 

HWORD 

32  bit  unsigned  integer 

unsigned  int 

WORD 

32  bit  real 

float 

REAL_4 

64  bit  real 

double 

REAL_8 

This  file  is  also  located  in  the  /cig/othersrc/force  directory. 

Included  By:  aa_init.c 

backend_*.c  (all  files) 

bit_blt.c 

bootforce.c 

bootmpv.c 

cf_translator.c 

cig_2d_setup.c 

cig_comp_2d.c 

comp.c 

draw_line.c 

esifa_*.c  (all  files) 

fO_*.c  (all  files) 

fl_*.c  (all  files) 

flea.c 

flea_bal_opts.c 

flea_simulate_vehicles.c 

forcetask.c 

get_thing.c 

get_vehicle_position.c 

global_init.c 

gossip.c 

gspjo.c 

host_drl  l_if,c 

host_ex_if.c 

host_mpv_if.c 

host_socket_if,c 

init_sim.c 

init_stuff.c 

load_esifa.c 

loadmpv.c 

mpvideo_*.c  (all  files) 

rosg_*.c  (all  files  except  msg_calibration_image.c) 

mx2_hword.c 

mx3_hword.c 

nmLtype.c 

otherveh_state.c 

oval_rect.c 

polLready.c 
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poly.c 

ppm_obj.c 

prctend_veh.c 

print_msg.c 

proc_cmd.c 

real_time.h 

replace_mod.c 

simulation.c 

staticveh_remove.c 

staticveh_state.c 

string.c 

sys_control.c 

sysdefs2.h 

tesccommands.c 

test_gsp.c 

text.c 

u_*_2d.c  (all  files) 
window.c 


A. 25  /cig/include/dgi_stdg.h 

The  dgi_stdg.h  file  defines  various  graphics  structures.  It  includes  typedefs  for  the 
following: 

•  2-D,  3-D,  and  4-D  vertex  points. 

•  4x3  matrix. 

•  2-D  and  3-D  bounding  boxes. 

•  Red,  green,  blue. 

•  Red,  green,  blue,  opaque. 

•  Hue,  saturation,  lightness. 

•  Hue,  saturation,  lightness,  opaque. 

Included  By:  cf_translator.c 

flea.c 

flea_bal_opts.c 

flea_simulate_vehicles,c 

get_vehicle_position.c 

global_init.c 

gossip.c 

host_drl  l_if.c 

host_ex_if.c 

host_mpv_if.c 

host_socket_if.c 

init_sim.c 

mpvideo_response.c 

msg_*,c  (all  files  except  msg_calibration_image.c  and 
msg_syserr.c) 
otherveh_state.c 
pretend_veh.c 
print_msg.c 
real_time.h 
simulation.c 
staticveh_remove.c 
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staticveh_state.c 

A. 26  /cig/include/dig_defines.h 

The  dig_defmes.h  file  defines  variables  used  for  the  digitizer  interface. 

Included  By:  flea_demo.c 

gosjocate.c 


A. 27  /cig/include/dig_struct.h 

The  dig_structh  file  defines  the  DIGrnZER_INTERFACE  structure. 
Included  By:  flea_denio.c 


A. 28  /cig/include/ecompilerl.h 

The  ecompilerl.h  file  contains  defines  for  the  DTP  command  generator,  including  various 
DTP  addresses,  maximum  values,  and  the  typedef  for  the  where_process  structure  (used 
for  pre-  and  post-processing  models  and  effects). 

This  file  includes  the  real_time.h  and  ememory_map.h  files. 

Included  By:  dtp_compiler.c 

dtp_funcs.c 
dtp_travl.c 
dtp_trav2.c 
gossip.c 
init_sim.c 
msg_cig_cd.c 
msg_drll.c 
msg_end.c 
nisg_pass_on.c 
msg_vport.c 
otherveh_state.c 
real_time.h 
real_timevpt.h 
simulation.c 
staticveh_renK)ve.c 
staticveh_state.c 


A. 29  /cig/include/emeinory_niap.h 

The  ememory_map.h  file  provides  external  memory  declarations.  It  includes  the  following: 

•  General-use  variables,  such  as  My  Vehicle  id,  names  of  the  loaded  files,  and  the 
database  column  markers. 

•  Database  format  variables. 

•  Database  management  variables,  such  as  the  number  of  load  modules  on  a  side, 
load  module  width,  and  the  total  number  of  load  modules. 
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•  Variables  for  ballistics  and  flea. 

•  Timing  and  control  word  variables. 

•  Local  terrain  and  range  variables. 

•  Declarations  for  the  DRl  1-W  interface. 

•  Declarations  to  support  runtime  configurable  DR  packet  sizes. 

•  Intertask  Semaphore  mailbox  declarations. 

•  Debugging  and  data  gathering  variables. 

•  Variables  for  Flea's  keyboard  interface. 

•  FCXjM  missile  mode  global  variables. 

•  Variables  used  with  Force  and  GSP. 

•  Single  step  flags. 

•  Ballistics  flags. 

•  Helicopter  blade  rotation  variables. 

•  The  GLOB  (global  memory)  macro. 

This  file  also  includes  the  memory_map_defines.h  file. 

Included  By;  aam_manager.c 

autopilot.c 
bal_routines.c 
be_stubs.c 
bx_task.c 
cal.c 

cig_config.c 

cig_getm_2d.c 

cigsimio_obj.c 

close_db.c 

clouds.c 

config_ballistics.c 

config_color_table.c 

config_database.c 

db_mcc_setup.c 

debug_initdr.c 

ded_model_trace.c 

dtp_emu.c 

dynamic_demo.c 

effect_downcount.c 

file_control.c 

flea.c 

flea_*.c  (all  files  except  flea_simulate_vehicles.c) 

generic_lm.c 

get_sio_data.c 

get_tx_lut_index.c 

gos_12()tx.c 

gos_db_query.c 

gos_memory.c 

gos_model.c 

gos_mpv,c 

gos_mpvio.c 

gos_polys.c 

gos_system.c 

gossip.c 

gun_overlays.c 

host_enet_if.c 
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host_flea_if.c 

host_if_debug.c 

host_scsi_if.c 

hw_test.c 

load_dbase.c 

load_modules.c 

loc_ter.c 

loc_ter_msg.c 

make_bbn.c 

make_bbn_logo.c 

mkcal.c 

model_demo.c 

model_mtx.c 

model_mtx.c 

msg_calibration_image  .c 

msg_cig_ctl,c 

msg_drl  1  .c 

msg_end.c 

msg_pass_on.c 

msg_subsys_mode.c 

msg_vport.c 

open_dbase.c 

open_ded.c 

rowcol_rd.c 

show_effect_msg.c 

simulation.c 

tick.c 

tick_ppm.c 

tick_script.c 

update_2d.c 

update_agpt_2d.c 


A. 30  /cig/include/esifa.h 

The  esifa.h  file  defines  the  structures  used  to  communicate  with  the  ESIFA  board  on  the 
SCSI  bus  using  the  ifx_ioctl  call.  It  includes  the  typedefs  for  the  ESIFA  object  and  the 
ESIFA  ports  structure. 

Included  By:  backend_color.c 

backend_man.c 
esifa_*.c  (all  files) 
flea.c 
gossip.c 
msg_cig_ctl.c 
msg_drl  1  .c 
msg_end.c 
msg_pass_on.c 
msgLSubsys_mode.c 
msg_vport.c 
ppm_obj.c 
real_time.h 
real_timevpt.h 
simulation.c 
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A .  3 1  /cig/othersrc/force/f  l_defines.h 

The  fl_defines.h  file  defines  Force  constants  such  as  the  following: 

•  The  size  of  each  Force  message  buffer. 

•  The  base  address  of  each  Force  message  buffer. 

•  Typedefs  for  the  MODE_SELECT_STRUCT  and  SWITCH_2DLUT_STRUCT 
structures. 

Included  By:  fD_*.c  (all  files) 

fl_*.c  (all  files) 

fl_defines.h 

forcetask.c 

gsp_io.c 

poll_ready.c 


A .  3  2  /cig/othersrc/force/fl_externs.h 

The  fl_extems.h  file  defines  various  external  Force  global  variables,  including: 

•  The  pointer  to  the  Force  environment. 

•  Pointers  to  the  message  buffers. 

•  nmi_set_flag  (indicates  whether  or  not  GSP  is  running). 

•  Force  scratch  buffer  (force_tmp_buffer[]). 

•  Function  jump  table  for  message  processing  (*FG_message_table[]). 

•  Local  anidogues  of  the  MPV  registers. 

•  FG_mpv_type,  FG_final_lut_type,  FG_mpv_mode,  and  FG_mpv_orient. 

•  FG_pixel_addr[],  FG_pixel_id[],  and  FG_new_pixel_req_flag[]. 

•  FG_mpv_cluts_gsp  and  FG_mpv_cluts_force. 

•  FG_3dlut_downloaded_flag. 

•  FG_pixel_depth_message  and  FG_pixel_depth_flag[]. 

•  FG_debug_flag. 

Included  By:  fO_*.c  (all  files) 

fl_extems.h 

fl_force_init.c 

fl_initjump_table.c 

fl_process_messages.c 

fl_setup_environment.c 

gsp_io.c 

poll_ready.c 


A. 3 3  /cig/othersrc/force/f l_globals.h 

The  fl_globals.h  file  defines  various  Force  global  variables,  including: 

•  Pointers  to  the  message  buffers. 

•  nmi_set_flag  (indicates  whether  or  not  GSP  is  running). 

•  Force  scratch  buffer  (force_tmp_buffer[]). 

•  *force_interface  (mailbox  address) 
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•  Function  jump  table  for  message  processing  (*FG_message_table[]). 

•  Local  analogues  of  the  MPV  registers. 

•  FG_mpv_type,  FG_final_lut_type,  FG_mpv_mode,  and  FG_mpv_orient. 

•  FG_pixel_addr[],  FG_pixel_id[],  and  FG_new_pixel_req_flag[]. 

•  FG_mpv_cluts_gsp  and  FG_mpv_cluts_force. 

•  FG_3dlut_downloaded_flag. 

•  FG_pixel_depth_message  and  FG_pixel_depth_flag[]. 

•  FG_debug_flag. 

Included  By:  forcetask.c 


A .  3 4  /cig/othersrc/force/force_defines.h 

The  force_defines.h  file,  which  contains  Force  and  GSP  definitions,  serves  as  the  interface 
between  the  real-time  software.  Force,  and  the  GSP.  It  includes  defines  for  the  following: 

•  FE_CONTROL  (the  front-end  control  r.gister). 

•  FORCE_CONTROL  (the  Force  conrol  register). 

•  Force  return  status  and  error  areas. 

•  Pixel  depth  request  values. 

•  Lookup  table  variables. 

•  Incoming  and  outgoing  data  buffer  areas. 

•  Video  control  variables. 

•  GSP  host  control  interface  words. 

•  The  READ.CLOCK,  RESTART.CLOCK,  and  CHECK.CLOCK  macros  (no 
longer  used). 

•  The  typedef  for  the  FORCE_I>rrERFACE  structure. 

Included  By:  data_type.c 

fO_set_display.c 

gsp_io.c 

nmi_type.c 

test_gsp.c 


A. 35  /cig/othersrc/force/force_env.h 

The  force_env.h  file  contains  the  typedef  for  the  FORCE_ENVIRONMENT  structure, 
which  defines  Force  memory. 

This  file  is  also  located  in  the  /cig/include  directory. 

Included  By:  fl_defines.h 

f  1  _init Jump_table.c 
fl_process_messages.c 
force_env.h 
force_rtsw_if.h 


A. 36  /cig/othersrc/force/force_rtsw_if.h 

The  force_rtsw_if.h  file  defines  the  interface  between  Force  and  the  real-time  software.  It 
defines  the  following: 


737 


BBN  Systems  and  Technologies 


GTIOO  RTSW  CSCI 


•  MAX  ORIENTATIONS  and  MAX_RESOLUTIONS. 

•  ORT^  ^  VERTICAL  and  ORIENT_HORIZONTAL. 

•  RE5_C  ''  180,  RES_320x240.  RES_640x256,  and  RES_640x240. 

•  The  FORCE_ENVIRONMENT  structure. 

•  The  message  code  and  body  of  the  MSG_F0_QUERY  message. 

•  The  message  code  and  body  of  the  MSG_F1_TEXT  message. 

Included  By:  none 


A. 37  /cig/othersrc/force/force.h.asm 

The  force.h.asm  file  defines  constants  for  the  Force  data  link.  It  sets  up  the  68230  base 
register  and  defines  GCR  codes,  address  select  codes  for  GSP  registers,  and  LED  bit 
definitions. 

Included  By:  force.asm 


A. 38  /cig/include/functions.h 

The  functions.h  file  defines  the  following  macros  used  by  various  functions  in  the  real-time 
software.  These  macros  are  described  in  Appendix  B. 

•  AAM2_ADDR 

•  DART.ENQUEUE 

•  DUMP_DART_BUFFER 

•  EXCHANGE_FLEA_DATA 

•  FIND_LM 

•  FXT0881 

•  INTT.MTX 

•  OPEN_FLEA_DATA 

•  SYSERR 

•  TRIGGER_FORCE 

•  WArr_FORCE 

Included  By:  backend_color.c 

backend_paths.c 
backend_thermal  .c 
cf_translator.c 
esifa_laser,c 
esifa_man.c 
flea.c 

flea_simulate_vehicles.c 

init_sim.c 

mpvideo_laser.c 

mpvideo_man.c 

mpvideo_response.c 

nisg_cig_ctl.c 

msg_drl  1  .c 

msg_end.c 

msg_laser.c 

msg_laser_retum.c 


738 


BBN  Systems  and  Technologies 


GT100RTSW  CSCI 


nisg_lt_state.c 

msg_pass_on.c 

msg_ppm.c 

msg_pr(xess_round4  8  .c 

msg_vport.c 

otherveh_state.c 

real_time.h 

rcal_timevpLh 

staticveh_remove.c 

staticveh_state.c 


A. 39  /cig/include/global_2d.h 

The  global_2d.h  file  includes  the  defmes_2d.h  and  struct_2d.h  include  files.  Collectively, 
these  files  declare  all  global  I/O  variables,  global  temporary  compiler  variables,  and 
compiler  product  variables  for  the  2-D  compiler. 

Included  By:  bit_blt.c 

cig_comp_2d.c 

cig_getm_2d.c 

cig_link_2d.c 

comp.c 

draw_line.c 

get_thing.c 

init_stuff.c 

oval_rect.c 

poly.c 

proc_cmd.c 

string.c 

text.c 

u_comp_2d.c 

u_getm_2d.c 

u_link_2d.c 

window.c 


A. 40  /cig/include/globfir_2d.h 

The  globfir_2d.h  file  includes  the  defines_2d.h  and  struct_2d.h  include  files.  Collectively, 
these  files  declare  all  global  I/O  variables,  global  temporary  compiler  variables,  and 
compiler  product  variables  for  the  2-D  compiler. 

Included  By;  cig_2d_setup.c 

u_main2d.c 


A. 41  /cig/include/if_cig2siiii.h 

The  if_cig2sim.h  file  defines  the  structures  of  the  runtime  messages  sent  from  the  CIG  to 
the  Simulation  Host.  These  messages  are: 

•  MSG_AGL 

•  MSG_HIT_RETURN 
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•  MSG_LASER_RETURN 

•  MSG_LOCAL_TERRAIN 

•  MSG_LT_PIECE 

•  MSG_MISS 

•  MSG_PASS_BACK 

•  MSG_RETURN_POINT_INFO 

•  MSG_SHOT_REPORT 

•  MSG_TF_HDR 

•  MSG_TF_PT 

Included  By:  flea.c 

flea_bal_opts.c 

flea_siniulate_vehicles.c 

global_init.c 

gossip.c 

init_sim.c 

msg_cig_ctl.c 

msg_drll.c 

msg_effect.c 

msg_end.c 

msg_laser_retum.c 

msg_pass_back.c 

msg_pass_on.c 

nisg_process_round48  .c 

msg_subsys_niode.c 

msg_veh_state.c 

msg_vport.c 

print_msg.c 

sim_cig_if.h 


A. 42  /cig/include/if_ctl_err.h 

The  if_ctl_err.h  file  defines  the  structures  of  the  control  and  error  messages  passed  between 
the  CIG  and  the  Simulation  Host.  These  messages  are: 

•  MSG_CIG_CTL 

•  MSG_DR11_PKT_SIZE 

•  MSG_SYS_ERROR 

This  file  also  defines  the  structure  of  the  message  header  (MSG_HDR),  end  of  message 
indicator  (MSG_END),  and  packet  header  (MSGS_BLK). 

Included  By:  flea.c 

flea_bal_opts.c 

flea_simulate_vehicles.c 

global_init.c 

gossip.c 

host_drl  l_if.c 

host_ex_if.c 

host_mpv_if.c 

host_socket_if.c 

init_sim.c 

mpvideo_response.c 
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msg_*.c  (all  files  except  msg_calibration_image.c) 

otherveh_state.c 

prctend_veh.c 

print_msg.c 

sim_cig_if.h 

simulation.c 

staticveh_remove.c 

staticveh_state.c 


A. 43  /cig/include/if_hdr_str.h 

The  if_hdr_str.h  defines  the  matrix  structures  (RTS4x3_MTX,  RTS3x3_MTX, 
ROT2xl_MTX,  MTXUNION,  and  XYZHPR).  It  also  defines  the  structures  for  field-of- 
view,  resolution,  and  the  vector  for  describing  angles  of  rotation. 

Included  By:  flea.c 

flea_bal_opts.c 

flea_simulate_vehicles.c 

global_init.c 

gossip.c 

init_sim.c 

mpvideo_response.c 

ntsg_*-C  (all  files  except  msg_calibration_image.c  and 
msg_syserr.c) 
otherveh_state.c 
print_msg.c 
sim_ci^if.h 
simulation.c 
staticveh_remove.c 
staticveh_state.c 


A. 44  /cig/include/if_init.h 


The  if_init.h  file  defines  the  structures  of  the  initialization  messages  sent  to  the  CIG  from 
the  Simulation  Host.  These  messages  are: 

•  MSG_2D_SETUP 

•  MSG_TRAJ_TABLE_XFER 

•  MSG_TRAJ_ENTRY_XFER 

•  MSG_CREATE_CONnGNODE 

•  MSG_VIEWPORT_STATE 

•  MSG_OVERLAY_SETUP 

•  MSG_DEFINE_TX_MODE 

•  MSG_AMMO_DEFINE 


gossip.c 

print_msg.c 

sim_cig_if.h 

simulation.c 


Included  By: 
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A. 45  /cig/include/if_nisg_ids.h 

The  if_msg_ids.h  file  defines  the  numerical  message  code  for  each  valid  message  type. 

Included  By:  flea.c 

gossip.c 

host_ex_if.c 

msg_cig_cd.c 

msg_drll.c 

msg_end.c 

msg_pass_on.c 

msg_subsys_mode.c 

msg_vport.c 

simulation.c 


A. 46  /cig/include/if_rva2net.h 

The  if_rva2net.h  file  provides  the  message  structures  for  alternate  versions  of  some  of  the 
standard  Ballistics  messages.  These  messages,  which  allow  for  48-bit  identifiers,  are  not 
used  with  the  standard  GTIOO  system. 

•  MSG_HIT_RETURN48 

•  MSG_TF_PT48 

•  MSG_SHOT_REPORT48 

Included  By:  msg_process_round48.c 

print_msg.c 


A. 47  /cig/include/if_sim2cig.h 


The  if_sim2cig.h  file  defines  the  structures  of  the  messages  sent  to  the  CIG  by  the 
Simulation  Host.  These  messages  are: 


•  MSG.IROTATION 

•  MSG_3ROTATIONS 

•  MSG_ADD_TRAJ_TABLE 

•  MSG_AGL_SETUP 

•  MSG_CALIBRATION_IMAGE 

•  MSG_CANCEL_ROUND 

•  MSG_CLOUD_STATE 

•  MSG_DATA_TEST 

•  MSG_DELETE_TRAJ_TABLE 

•  MSG_GUN_OVERLAY 

•  MSG_HPRXYZS_MATRIX 

•  MSG_LT_STATE 

•  MSG.OBSCURE 

•  MSG_OTHERVEH_STATE 

•  MSG_PASS_ON 

•  MSG_PPM_DISPLAY_MODE 

•  MSG_PPM_DISPLAY_OFFSET 
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•  msg_ppm_pixel_lcx:ation 

•  MSG_PPM_PIXEL_STATE 

•  MSG_PROCESS_CHORD 

•  MSG_PROCESS_ROUND 

•  MSG_PROCESS_ROUND48 

•  MSG_REQUEST_LASER_RANGE 

•  MSG_REQUEST_POINT_INFO 

•  MSG_ROT2xl_MATRIX 

•  MSG_ROUND_FIRED 

•  MSG_RTS4x3_MATRIX 

•  MSG_SCALE 

•  MSG_SHOW_EFFECT 

•  MSG_SIO_CLOSE 

•  MSG_SIO_INIT 

•  MSG.SIO.WRTTE 

•  MSG_STATICVEH_REM 

•  MSG_STATrCVEH_STATE 

•  MSG_SUBSYS_MODE 

•  MSG_TF_INIT_HDR 

•  MSG_TF_INIT_PT 

•  MSG_TF_STATE 

•  MSG_TF_VEHICLE_POS 

•  MSG_TRAJ_CHORD 

•  MSG_TRAJ_ENTRY 

•  MSG.TRANSLATION 

•  MSG_VIEW_FLAGS 

•  MSG.VffiW  MAGNmCATION 

•  MSG_VIEWPORT_UPDATE 

Included  By:  flea.c 

flea_bal_opts.c 

flea_simulate_vehicles.c 

gossip.c 

init_sim.c 

nisg_cig_ctl.c 

msg_drl  1  .c 

msg_effect.c 

msg_end.c 

msg_laser.c 

insg_lt_state.c 

msg_pass_on.c 

msg_ppm.c 

msg_process_round48.c 

msg_subsys_mode.c 

msg_veh_state.c 

msg_vflags.c 

msg_vport.c 

otherveh_state.c 

print_msg.c 

sim_cig_if.h 

simulation. c 

staticveh_remove.c 

staticveh_state.c 
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A. 48  /cig/include/if_tst_ctl.h 

The  if_tst_ctl.h  file  defines  the  structures  of  the  SIM-to-CIG  messages  used  for  file  control 
and  hardware  testing.  These  messages  are: 

•  MSG_FILE_DESCR 

•  MSG_FILE_STATUS 

•  MSG_FILE_XFER 

•  MSG_TEST_NAME 

Included  By:  gossip.c 

print_msg.c 

simulation.c 


A. 49  /cig/include/if_veh_eff.h 

The  if_veh_eff.h  file  contains  defines  that  affect  dynamic  vehicles  and  special  effects.  It 
defines  system  limits  (MAX_NUM_TANKS,  MAX_NUM_VEH,  MAX_ACT_EFF, 
MAX_STAT_TANKS,  and  MAX_STAT_VEH),  ASID  bumper  number  characters,  and 
ASK)  special  effects. 

Included  By:  gossip.c 

init_sim.c 
msg_cig_ctl.c 
msg_drll.c 
msg_effect.c 
msg_end.c 
msg_pass_on.c 
msg_veh_state.c 
msg_vport.c 
otherveh_state.c 
print_msg.c 
sim_cig_if.h 
simulation.c 
staticveh_remove.c 
staticveh_state.c 


A. 50  /gt/include/ifxvisi.h 

The  ifxvisi.h  file  provides  definitions  used  when  using  the  Ready  Systems  IFX  routines  to 
manage  and  access  files.  It  includes  IFX  function  codes;  the  access  modes  for  ifx_open; 
the  options  for  ifx_mount,  ifx_delete,  and  ifx_nndir,  I/O  control  operation  codes;  device 
types;  IFX  error  codes;  and  the  structure  of  the  directory  entry. 

Included  By:  bxl47_main.c 

cigsimio_obj.c 
directory  .c 
esifa_load.c 
esifa_man.c 
esifa_queTy.c 
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find_gtfn.c 

flea_script.c 

host_enet_if.c 

host_scsi_if.c 

ppm_obj.c 

rtLc 

rtt_iniLc 

sio.c 

stdopen.c 

tick_script.c 


A. 51  /cig/include/keywords.h 

The  keywords.h  file  defines  the  table  of  keywords  recognized  by  lexical  analyzer  in  the 
Token  Processing  CSC.  This  file  includes  lex.h. 

Included  By:  lex.c 


A. 52  /cig/include/kludge.h 

The  kludge.h  file  defines  the  AAMl_TO_AAM2  and  VME_TO_VMX  macros  (described  in 
Appendix  B).  It  also  declares  several  of  the  Message  Processing  functions. 

Included  By:  msg_cig_ctl.c 

msg_drll.c 
msg_effect.c 
msg_end.c 
msg_veh_state.c 
msg_vport.c 
simulation.c 


A. 53  /cig/include/lex.h 

The  lex.h  file  defines  the  lexical  tokens  recognized  by  the  lexical  analyser  in  the  Token 
Processing  CSC. 

Included  By:  keyword.h 

lex.c 

subsy  s_cfg_parse  .c 


A. 54  /cig/include/m2_config.h 

The  m2_config.h  file  contains  defines  specific  to  the  M2.  It  defines  channel  and  gunner 
resolution,  viewport  angular  offsets,  pitch  up/down  angular  offsets,  field-of-view  sizes  for 
all  channels,  and  texture  map  definitions. 

Included  By:  gun_overlays.c 
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A. 55  /gt/include/math.h 

The  math.h  file  declares  standard  math  functions. 

Included  By:  bal_routines.c 

bx_bvol_intc 
bx_poly_inLc 
bx_task.c 
cnode_child.c 
cnode_process.c 
cnode_query.c 
cnode_set.c 
dtp_emu.c 
dynamic_demo.c 
encode_routines.c 
filLtree.c 

flea_agl_terrain_follow.c 

flea_agpt_locations.c 

flea_agpt_switches.c 

flea_bal_opts.c 

flea_db_traverse.c 

flea_decode_data.c 

flea_init_cig_sw.c 

flea_ppm_obj.c 

flea_script.c 

flea_simulate_vehicles.c 

flea_switches.c 

flea_update_pos.c 

flea_veh_control.c 

gos_120tx.c 

gos_model.c 

gos_mpv.c 

gos_mpvio.c 

gossip.c 

linkvpt.c 

mkcal.c 

model_demo.c 

mtx_concat.c 

mtx_viewspace.c 

nix_enor.c 

path.c 

path_init.c 

path_query.c 

shot_report.c 

simulation.c 

tick_ppm.c 

tick_script.c 

trav_tree.c 

tst_eupdate.c 

u_bnnask.c 

u_path.c 

u_rotations.c 
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u_viewport.c 

u_xfrm.c 

update_2d.c 

update_agpt_2d.c 

update_mtx.c 

update_roLc 

vpt_process.c 

vpt_query.c 

vpt_seLc 

vpt_update.c 


A. 56  /cig/include/mbx.h 

The  mbx.h  file  contains  defines  for  the  interface  with  the  Force  board.  It  includes  defines 
for  the  following: 

•  The  FORCE_INTERFACE  structure. 

•  NMI  and  GSP  configuration  addresses. 

•  Force  masks  (slave/host,  resolution,  front  ready,  force  busy,  etc.). 

•  FE_CONTROL  register  commands  (SUBS Y S_^AD_ST ART, 
SUBSYS_TEST_MEM,  etc.). 

•  Video  control  parameters  (VIDEO_CrrL_ADDR,  VIDEO_ON_CODE,  etc.). 

•  GSP  memory  stan  and  end  addresses. 

This  file  is  also  located  in  the  /cig/othersrc/force  directory. 

Included  By:  fO_*.c  (aU  files) 

fl_*.c  (aU  files) 
flea.c 

forcetask.c 

gossip.c 

nisg_cig_ctl.c 

msg_drll.c 

msg_end.c 

msg_pass_on.c 

msg_subsys_mode.c 

msg_vport.c 

poll_ready.c 

process_vflags.c 

real_time.h 

real_timevpt.h 

simulation.c 


A. 57  /cig/include/memory_inap.h 

The  memory_map.h  file  contains  external  memory  declarations  such  as  the  following: 

•  Variables  describing  the  simulated  vehicle  (myvehjd,  myveh_type,  etc.). 

•  Database  management  variables. 

•  Local  terrain  and  range  vanables. 

•  Terrain  feedback  variables. 

•  Declarations  for  the  DRl  1-W  interface. 
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•  Intertask  semaphore  mailbox  declarations. 

•  The  displayjights  array. 

•  Viewport  position  and  rotation  data  for  flying  and  setting  individual  views. 

•  Variables  used  by  Flea’s  keyboard  interface  for  flying. 

•  Helicopter  blade  rotation  variables. 

•  Initialized  values  for  the  message  packet  size  and  local  terrain  chunk  size. 

•  The  GLOB  (global  memory)  macro,  defined  in  Appendix  B. 

This  file  include  memory_map_defines.h 
Included  By:  upstart.c 


A. 5 8  /cig/incIude/meinory_inap_defines.h 

The  memory_map_defines.h  file  defines  variables  used  in  external  memory  declarations, 
including  the  following: 

•  The  size  of  a  load  module. 

•  The  areas  of  the  64KW  memory  board  (32KW  of  space  for  the  double-buffer  state 
table  and  32KW  of  generic  memory  for  the  database). 

•  Byte  offsets  to  data  in  double-buffered  state  table  memory. 

•  Declarations  for  the  DR  1 1  -W  interface. 

•  Local  terrain  message  interval  and  starting  frame  number. 

•  Intertask  semaphore  mailbox  locations. 

•  Display  lights  locations. 

•  Viewport  position  and  rotation  data  for  flying  and  setting  individual  views. 

•  Helicopter  blade  rotation  variables,  used  in  simulation. 

Included  By:  aa_init.c 

backend_branch.c 

backend_color.c 

backend_man.c 

backend_paths.c 

backend_thermal  .c 

ball_effect_add.c 

cig_link_2d.c 

dl_man.c 

ememory_map.h 

esifa_man.c 

global_init.c 

host_ex_if.c 

init_sim.c 

mcmory_map.h 

mpvideo_man.c 

msg_effect.c 

msg_laser_retum.c 

msg_pass_back.c 

msg_veh_state.c 

otherveh_state.c 

process_vfIags.c 

process_vppos.c 

rtt.c 

rtt_init.c 
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staticveh_remove  .c 

staticveh_state.c 

sys_control.c 


A. 5 9  /cig/include/inodel_struct.h 

The  model_structh  file  provides  the  typedefs  for  the  following  model  structures: 

•  Static  tank. 

•  Single-transform  model. 

•  ASro  single-transform  model. 

•  Remove  static  model. 

•  Tank. 

•  Show  effects  stamp. 

•  ASID  show  effects  stamp. 

•  Fake  dynamic  vehicle. 

This  file  includes  standard.h,  poly_struct.h,  and  sim_cig_if.h. 

Included  By:  db_struct.h 

real_timevpt.h 


A .  6 0  /cig/othersrc/force/mpv_mdef.h 

The  mpv_mdef.h  file  defines  memory  locations  in  the  MPV  that  are  used  by  Force  and  the 
2-D  task.  It  includes  MPV  register  locations  and  locations  used  in  the  Force/MPV 
interface. 

Included  By:  fl_defines.h 


A.  61  /cig/othersrc/force/mpv_memory_defines.h 

The  mpv_memory_defines.h  file  defines  MPV  register  locations. 

Included  By:  mpv_mdef.h 

mpv_memory_defines.h 


A. 62  /cig/include/inpv_struct.h 

The  mpv_strucLh  file  provides  typedefs  for  the  following  MPV  structures: 

•  Color  table. 

•  Fade  transfer. 

•  Video  control. 

•  DTP  mode  switch. 


This  file  includes  standard.h. 

Included  By:  process_vflags.c 

real_timevpt.h 
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A. 63  /cig/include/mpvideo.h 

The  mpvideo.h  file  defines  the  interface  to  the  MPV  board.  It  defines  the  following: 

•  The  MPVIO_INTERFACE  structure. 

•  All  Force  commands  (SUBSYS_READ_START,  SUBSYS_MAIL_SEND,  etc.). 

•  Video  control  commands. 

•  Force/GSP  masks. 

•  The  WArr_MPVIO  macro. 

•  The  MPVIDEO.CONTROL  and  MPVIDEO_OB  J  structures. 

Included  By:  backend_man.c 

bootforce.c 
bootmpv.c 
cig_2d_setup.c 
cig_comp_2d.c 
cig_link_2d.c 
esifa_man.c 
loadmpv.c 

mpvideo_*.c  (all  files  except  mpvideo_print.c) 


A. 64  /cig/include/mpvideo_msg.h 

The  mpvideo_msg.h  file  provides  the  typedefs  for  all  messages  sent  between  the  real-time 
software  and  the  MPV  via  the  Force  board.  Both  M_F0_*  ^TSW->Force)  and  M_F1_* 
(Force->RTSW)  messages  are  included.  This  file  also  defines  the  message  codes  and 
various  variables  used  in  the  messages. 

This  file  is  also  located  in  the  /cig/othersrc/force  directory. 

Included  By:  bootmpv.c 

fO_*.c  (all  files) 

fl_*.c  (all  files) 

forcetask.c 

gos_mpvio.c 

gsp_io.c 

loadmpv.c 

mpvideo_laser.c 

mpvideo_lut.c 

mpvideo_man.c 

mpvideo_mode.c 

mpvideo_msg.h 

mpvideo_response.c 

poll_ready.c 


A. 65  /cig/include/mx_defines.h 
The  mx_defines.h  file  defines  the  following: 
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•  Constants  used  for  Ballistics  message  queue  processing  (MX_DEVICE_CLOSED, 
MX_DEVICE_TABLE_FULL,  etc.). 

•  The  MX_DEVICE  and  MESSAGE_HEADER  structures. 

•  The  BCOPY  macro  (described  in  Appendix  B). 

Included  By:  bal_routines.c 

ballistics.h 
config_ballistics.c 
download_bvols.c 
load_modules.c 
mx_*.c  (all  files) 
open_dbase.c 
rowcol_rd.c 
simulation. c 


A. 66  /cig/include/mx2_defines.h 

The  mx2_defines.h  file  defines  constants  used  for  MPV  message  queue  processing.  It 
includes  constants  for  the  MX  buffer  status  (MX_DEVICE_CLOSED, 
MX_DEVICE_TABLE_FULL,  etc.)  and  message  status  (MX_MESSAGE_SKIPPED. 
MX_MESSAGE_PUSHED,  etc.). 

This  file  is  also  located  in  the  /cig/othersrc/force  directory. 

Included  By:  bootmpv.c 

fO_*.c  (aU  files) 

fl_process_messages.c 

gos_mpvio.c 

loadmpv.c 

mpvideo_laser.c 

mpvideojut.c 

mpvideo_man.c 

mpvideo_mode.c 

mpvideo_response.c 

mx2_hword.c 

mx3_hword.c 


A. 67  /cig/include/overlay3d_struct.h 

The  overlay 3d_struct.h  file  provides  the  typedefs  for  the  Ml  gun  overlay,  M2  gun  overlay, 
gun  barrel  overlay,  calibration  overlay,  and  overlay  parameters  structures. 

This  file  includes  the  standard.h  and  poly_struct.h  files. 

Included  By:  dtp_trav2.c 

real_timevpt.h 


A. 68  /cig/incIude/ovrIy_defs.h 

The  ovTly_defs.h  file  defines  constants  used  to  create  calibration  overlays  (for  example,  the 
dimensions  of  the  frame  triangles). 
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Included  By: 


flea.c 
gossip  .c 
real_time.h 
simulation.c 


A. 69  /cig/incIude/poIy_struct.h 

The  poly_struct.h  file  provides  the  typedefs  for  the  polygon  command  lines,  poly  info 
word,  polygon  list,  and  stamp  list. 

This  file  includes  the  standard.h  and  traverse_cmd_defs.h  files. 

Included  By:  model_struct.h 

overlay  3d_struct.h 

real_timevpt.h 

vpi_viewport.h 


A. 70  /cig/include/ppm.h 

The  ppm.h  file  contains  definitions  used  when  processing  PPM  messages.  It  defines  the 
board  values  and  message  codes,  and  provides  the  typedef  for  the  PPM_DATA_TYPE 
structure. 

Included  By:  msg_ppm.c 


A. 7 1  /cig/include/print_insg_externs.h 

The  print_msg_extems.h  file  is  not  currently  used. 
Included  By  :  none 


A. 72  /cig/include/rcinclude.h 

The  rcinclude.h  file  is  used  by  the  DTP  command  generator  and  the  Runtime  Command 
Library.  It  does  the  following: 

•  Declares  all  RCL  functions  (rcl_push,  rcl_pop,  etc.). 

•  Declares  address  and  pointer  variables  used  by  the  RCL  commands. 

•  Defines  the  RCL_UNION  structure. 

•  Defines  the  macros  used  by  dtp_travl  and  dtp_trav2  to  generate  RCL  commands. 
These  macros,  which  are  defined  in  Appendix  B,  are  used  to  pass  the  appropriate 
data  to  rcLcommand,  rcljblcmd,  rcl_data,  and  rcl_component. 

Included  By:  dtp_compiler.c 

dtp_funcs.c 
dtp_travl.c 
dtp_trav2.c 
gos_model.c 
rcfuncs.c 
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replace_mod.c 

test_commands.c 


A. 73  /cig/include/real_time.h 

The  real_time.h  file  includes  many  of  the  include  files  used  in  the  real-time  software.  The 
files  it  includes  are  the  following; 

•  stdio.h 

•  dgi_stdc.h 

•  dgLstdg.h 

•  functions.h 

•  sim_cig_if.h 

•  rtdb_struct.h 

•  structures.h 

•  definitions. h 

•  ovrly_defs.h 

•  def_alloc.h 

•  mbx.h 

•  esifa.h 

•  clouds. h 

•  ecompilerl.h 

Included  By:  aam_manager.c 

autopilot.c 
bO_*.c  (all  files) 
bal_get_db_pos.c 
bal_get_lm_grid.c 
bal_routines.c 
ball_effect_add.c 
bx_*.c  (all  files) 
cal.c 

cig_getm_2d.c 

cig_link_2d.c 

cigsimio_obj.c 

close_db.c 

clouds.c 

config^ballistics.c 

config_color_table.c 

config_database.c 

db_mcc_setup.c 

debug_initdr.c 

ded_model_trace.c 

ded_object.c 

dl_man.c 

dLman.c 

download_bvoIs.c 

dtp_emu.c 

dynamic_demo.c 

effect_downcount.c 

file_control.c 

find_field.c 

find_gtfn.c 
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flea_*.c  (all  files  except  flea_simulate_vehicles.c) 

fxbvtofl.c 

generic_lm.c 

get_sio_data.c 

get_tx_lut_index.c 

gos_*.c  (all  files  except  gos_locate.c) 

host_enet_if.c 

host_flea_if.c 

host_if_debug.c 

host_scsi_if.c 

hw_test.c 

load_dbase.c 

load_modules.c 

loc_ter.c 

loc_ter_msg.c 

make_bbn.c 

make_bbn_logo.c 

mkcal.c 

model_demo.c 

model_mtx.c 

msg_calibration_image  .c 

mx_*.c  (all  files) 

open_dbase.c 

open_ded.c 

rowcoLrd.c 

shot_report.c 

show_effect_msg.c 

sio.c 

sload.c 

tick.c 

tick_ppm.c 

tick_script.c 

update_2d.c 

update_agpt_2d.c 

upstart.c 

vtlOO.c 


A. 74  /cig/include/real_tiinevpt.h 

The  real_timevpt.h  file  includes  the  following  files: 

•  stdio.h 

•  standard.h 

•  functions.h 

•  rtdb_struct.h 

•  poly_struct.h 

•  model_struct.h 

•  db_struct.h 

•  bal_struct.h 

•  mpv_struct.h 

•  vpLstruct.h 

•  overlay3d_struct.h 

•  sim_cig_if.h 
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•  definitions.h 

•  mbx.h 

•  esifa.h 

•  clouds.h 

•  ecompilerl.h 

Included  By:  be_stubs.c 

cig_config.c 
gun_overlays.c 
overlay_setup.c 


A .  7 5  /cig/incIude/rt_definitions.h 

The  rt_definitions.h  file  defines  constants  used  throughout  the  system  (e.g.,  PI,  TRUE, 
FALSE,  NULL,  and  various  constants  useful  as  tolerance  and  threshold  levels). 

Included  By:  bal_real_time.h 


A. 76  /cig/include/rt_inacros.h 

The  rt_macros.h  file  defines  the  following  macros:  DEGREE_TO_RADIAN,  TORAD, 
RADIAN_TO_DEGREE,  ABSVAL,  SQUARE,  MAGSQ2D,  MAGSQ3D,  CUBE,  SIGN, 
MAX,  MIN,  INTT.MTX,  FIND_LM,  FXT0881,  FLTOFX,  and  FXTOFL.  These  are 
described  in  Appendix  B. 

Included  By;  ha]_real_time.h 

A. 77  /cig/include/rt_types.h 

The  rt_types.h  file  defines  the  data  types  used  throughout  the  system  (INT_2, 1NT_4, 
etc.). 

Included  By:  bal_real_time 

A . 78  /cig/othersrc/force/rtcdefines.h 

The  rtcdefines.h  file  defines  constants  used  by  the  forcetask  to  read  and  reset  the  clock. 
Included  By:  forcetask.c 


A. 79  /cig/include/rtdb_struct.h 

The  rtdb_structh  file  defines  the  following  real-time  database  structures: 

•  Database  version  and  tag. 

•  Database  header  data. 

•  Database  header  overflow  and  landmark  data. 

•  Generic  module  directory  entry  data  and  name. 

•  Model  and  catalog  tables. 


755 


BBN  Systems  and  Technologies 


GTIOORTSW  CSCI 


•  Database  directory  entry. 

•  Load  module  header. 

•  Grid  locator  information. 

•  Fixed  bvol  entry 

•  Load  module  statistics. 

•  Floating  bvol  entry. 

This  file  also  defines  the  maximum  number  of  models  that  can  be  put  in  the  generic  module 
of  the  runtime  database,  the  maximum  number  of  stamps  in  one  unique  static  object 
definition,  and  the  number  of  z  values  in  a  grid  component. 

Included  By:  flea.c 

flea_bal_opts.c 

gossip.c 

init_sim.c 

msg_cig_ctl.c 

msg_drll.c 

msg_effect.c 

msg_end.c 

msg_pass_on.c 

msg_subsys_mode.c 

msg_veh_state.c 

msg_vflags.c" 

msg  vport.c 

otherveh_state.c 

real_time.h 

real_timevpt.h 

simulation.c 

staticveh_remove.c 

staticveh_state.c 


A. 80  /cig/inciude/sim_cig_defines.h 

The  sim_cig_defines.h  file  defines  the  message  code  for  every  C1G->S1M  and  S1M->CIG 
message.  It  also  defines  M_LAST_VALID_MSG  as  the  last  (highest)  valid  message  code. 

Included  By:  flea_simulate_vehicles.c 

global_init.c 
host_drl  l_if.c 
host_mpv_if.c 
host_socket_if.c 
init_sim.c 

mpvideo_response.c 

msg_effect.c 

msg_laser.c 

msg_laser_retum.c 

nisg_lt_state.c 

msg_pass_back.c 

msg_ppm.c 

msg_process_round48  .c 
msg_syserr.c 
msg_veh_state.c 
msg_vflags.c 
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print_msg.c 

rtt_init.c 

sim_cig_if.h 


A. 81  /clg/include/siin_cig_if.h 

The  sim_cig_if.h  file  includes  the  files  that  define  common  structures,  vehicles  and  effects, 
and  all  messages  passed  between  the  CIG  and  the  Simulation  Host.  TTiese  files  are: 


if  hdr  str.h 
if_veh~eff.h 
if~ctl  err.h 

if_tst_ctl.h 

if~sirn2cig.h 

if_cig2siin.h 


commonly  used  structure  definitions 

vehicle  and  effect  definitions 

CIG  control,  error,  and  packet  definition  messages 

initialization  messages 

test  and  control  messages 

runtime  SIM-to-CIG  messages 

runtime  CIG-to-SIM  messages 


This  file  also  includes  sim_cig_defines.h,  which  defines  all  valid  message  codes. 


Included  By:  bal_struct.h 

cf_translator.c 

encode_routines.c 

model_struct.h 

real_time.h 

real_timevpLh 


A. 82  /cig/include/sIavel33_functions.h 

The  slavel33_functions.h  file  declares  the  slave  133_malloc  function.  This  file  is  included 
by  ballistics.h  when  building  the  version  of  Ballistics  that  runs  on  a  Slave  board. 

Included  By:  ballistics.h 


A. 83  /cig/include/standard.h 

The  standard.h  file  defines  the  standard  data  types  (INT_2,  INT_4,  BYTE,  etc.);  2-,  3-, 
and  4-dimensional  vertex  points;  4x3  and  4x4  matrices:  2-  and  3-dirnensional  bounding 
boxes;  red,  green,  blue;  red,  green,  blue,  opaque;  hue,  saturation,  lightness;  hue, 
saturation,  lightness,  opaque. 

Included  By:  bal_struct.h 

cnode_*.c  (all  files) 

db_struct.h 

dtp_*.c  (all  files) 

encode_routines.c 

filLtree.c 

flagoff.c 

globs.c 

init_free.c 

linkvpt.c 

model_struct.h 
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mpv_struct.h 

mtx_*.c  (all  files) 

overlay  3d_struct.h 

path.c 

path_iniLc 

path_queiy.c 

poly_struct.h 

process_vflags.c 

process_vppos.c 

rcfuncs.c 

rcal_tiinevpLh 

trav_tree.c 

tst_*.c  (all  files) 

u_brmask.c 

u_path.c 

u_rotations.c 

u_viewport.c 

u_xfrm.c 

update_mtx.c 

update_rot.c 

vpi_query.h 

vpi_struct.h 

vpi_viewport.h 

vpt_*.c  (all  files) 


A. 84  /gt/include/stdio.h 

The  stdio.h  file  is  the  Ready  Systems  standard  input/output  header  file.  It  defines  flags 

used  for  file  i/o,  defines  various  constants,  and  declares  file  i/o  functions. 

Included  By:  aa_init.c 

backend_*.c  (all  files) 

bootforce.c 

bootmpv.c 

buffer_errors.c 

bxl47_main.c 

bx_task.c 

bx_task.c 

cf_translator.c 

cig_2d_setup.c 

cnode_*.c  (all  files) 

config_database.c 

db_mcc_setup.c 

directory  .c 

download_bvoIs.c 

dtp_*.c  (all  files) 

csifa_*.c  (all  files) 

flagoff.c 

flea.c 

flea_bal_opts.c 

flea_simulate_vehicles.c 

globs.c 

gossip.c 
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host_drl  l_if.c 

host_ex_if.c 

host_mpv_if.c 

host_socket_if.c 

init_fTee.c 

init_sim.c 

lex.c 

linkvpt.c 

load_esifa.c 

loadmpv.c 

inkintx_nt.c 

mpvideo_*.c  (all  files  except  mpvideo_printc) 

nisg_*.c  (all  files  except  msg_calibration_image.c) 

mtx_concaLc 

mtx_dump.c 

otherveh_state.c 

path.c 

path_init.c 

path_query.c 

ppm_obj.c 

pretend_veh.c 

print_msg.c 

real_time.h 

real_timevpt.h 

rtLc 

itt_initc 

shot_report.c 

simulation.c 

staticveh_remove.c 

staticveh_state.c 

subsys_cfg_parse.c 

sys_control.c 

tst_*.c  (all  files) 

u_*.c  (all  files) 

update_mtx.c 

update_rot.c 

vpt_*.c  (all  files) 


A. 85  /gt/include/strings.h 

The  strings.h  file  is  a  standard  header  file  that  declares  all  string-related  functions. 

Included  By:  flea.c 

flea_atp.c 

flea_bd_opts.c 

flea_switches.c 

host_if_debug.c 

mx_error.c 

print_msg.c 

rtt.c 

rtt_init.c 

tick.c 

tick_ppni.c 
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tick_scriptc 


A. 86  /cig/include/struct_2d.h 

The  struct_2d.h  file  defines  the  window  structures  used  by  the  2-D  compiler. 

Included  By:  global_2d.h 

globfir_2d.h 


A. 87  /cig/include/structures.h 

The  structures.h  file  defines  various  data  structures  used  to  process  overlays  and  static  and 
dynamic  models.  It  includes  typedefs  for  the  following  structures: 

•  Component  data  type  (3-D  point,  2-D  point,  and  vector). 

•  Texture  map  index. 

•  Polygon  information  word. 

•  Polygon  and  stamp  lists. 

•  Gunner,  bun  barrel,  and  calibration  overlays. 

•  Field-of-view  test  table. 

•  Load  module  call  tables. 

•  Static  and  dynamic  tanks. 

•  Static  and  dynamic  single-transform  models. 

•  Remove  static  model. 

•  Show  effects  (stamp  structure), 

•  Ballistics  chord  data. 

•  Trajectory  positions  and  data. 

•  Loii  module-specific  data. 

•  Grid  component  definition. 

This  file  also  defines  the  following: 

•  DTP  data  transformation  commands. 

•  DTP  data  component  commands. 

•  DTP  data  traversal  commands. 

•  Ballistics  and  local  terrain  data  pointers. 

•  Bounding  plane  definitions. 

•  Channel  defiititions. 

Included  By:  flea.c 

flea_bal_opts.c 

gossip.c 

init_sim.c 

msg_cig_ctl.c 

msg_drll.c 

insg_effect.c 

msg_end.c 

nisg_pass_on.c 

msg_subsys_modc.c 

msg_veh_state.c 

msg_vport.c 

otherveh_state.c 
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real_time.h 

simulations 

staticveh_remove.c 

staticveh_state.c 


A. 88  /cig/include/subsys_cfg_parse.h 

The  subsys_cfg_parse.h  file  defines  the  maximum  number  of  subsystems  and  the 
maximum  length  of  a  subsys.cfg  file. 

Included  By:  subsys_cfg_parse.c 


A. 89  /gt/include/sysdefs.h 

The  sysdefs.h  file  provides  system  definitions  for  operating  system  versions  RTOS.lOl 
and  RTOS.102.  It  includes  the  following: 

•  System- wide  memory,  resource,  and  software  and  hardware  fault  definitions. 

•  Task  definitions. 

•  I/O  control  system  definitions. 

•  VRTX  return  codes. 

•  Disk  manager  fault  codes. 

•  File  control  system  error  codes. 

•  Special  character  definitions. 

•  68901  equates. 

•  System  interrupt  equates. 

•  Definitions  and  structures  used  by  file_control. 

Included  By:  bxl47_main.c 

rttc 

rtt_initc 


A. 90  /cig/include/sysdefs2.h 

The  sysdefs2.h  file  provides  system  definitions  for  operating  system  version  FOS.lOO, 
which  allows  the  use  of  high-speed  disks.  It  includes  the  following: 

•  System-wide  memory,  resource,  and  software  and  hardware  fault  definitions. 

•  Task  definitions. 

•  I/O  control  system  definitions. 

•  VRTX  return  codes. 

•  Disk  manager  fault  codes. 

•  File  control  system  error  codes. 

•  Special  character  definitions. 

•  68901  equates. 

•  System  interrupt  equates. 

•  Definitions  and  structures  used  by  file_control. 


This  file  includes  the  dgi_stdc.h  file. 
Included  By:  getch.c 
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A. 91  /cig/include/tflat.h 

The  tflath  file  defines  Ballistics  round  trajectories  for  a  completely  flat  trajectory.  This  is  a 
default  table  loaded  for  testing  purposes. 

Included  By:  bx_init.c 

A. 92  /cig/include/tflat_7k.h 

The  tflat_7k.h  file  defines  Ballistics  round  trajectories  for  a  completely  flat  trajectory,  for 
use  with  7000-meter  viewing  ranges.  This  is  a  default  table  loaded  for  testing  purposes. 

Included  By:  bx_init.c 

A. 93  /cig/include/tflat_fast.h 

The  tflat_fasLh  file  defines  Ballistics  round  trajectories  for  a  completely  flat  trajectory  with 
a  very  fast  fly-out.  This  is  a  default  table  loaded  for  testing  purposes. 

Included  By:  bxjnit.c 


A. 94  /cig/include/tfIat_slow.h 

The  tflat_slow.h  file  defines  Ballistics  round  trajectories  for  a  completely  flat  trajectory  with 
a  very  slow  fly-out.  This  is  a  default  table  loaded  for  testing  purposes. 

Included  By:  bxjnit.c 


A. 95  /cig/include/traverse_cind_defs.h 
The  traverse_cmd_defs.h  file  defines  the  following: 

•  The  typedef  for  the  texture  map  indices  structure. 

•  The  command_id  values  for  all  transform  data,  data  components,  traverse  data  DTP 
commands. 

•  Constants  used  for  Ballistics  and  local  terrain  traversal. 

•  Maximum  buffer  sizes. 

•  Bounding  plane  definitions. 

•  Channel  definitions. 

Included  By:  poly_struct.h 


A. 96  /cig/include/ul05mmsabot30hz.h 

The  ul05mmsabot30hz.h  file  defines  Ballistics  round  trajectories  for  a  ulOSmmsabot 
round  with  a  30  Hz  sample  rate.  This  is  a  default  table  loaded  for  testing  purposes. 
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Included  By:  bxjnit.c 

A. 97  /cig/incIude/ulSmmheat.h 

The  u25minheat.h  file  defines  Ballistics  round  trajectories  for  a  u25mmheat  round  with  a 
15  Hz  sample  rate.  This  is  a  default  table  loaded  for  testing  purposes. 

Included  By;  bx_init.c 


A. 98  /cig/Iibsrc/Iibvpt/vpi_msgs.h 

The  vpLmsgs.h  file  provides  the  typedefs  for  the  messages  that  may  appear  in  the  ASCII 
viewport  configuration  file  process^  by  tst_ereadconfig.  It  also  defines  the  message  codes 
and  provides  the  typedefs  for  the  fov,  resolution,  and  terrain  feedback  point  stmctures. 

Included  By:  tst_ereadconfig.c 


A. 99  /cig/include/vpi_query.h 

The  vpLquery.h  file  defines  the  typedefs  for  the  vpt_cnode_info,  vpt_path_info,  and 
vpt_vpt_info  stmctures  used  when  querying  information  in  the  Viewport  Configuration 
tree. 


Included  By:  cnode_query.c 

path_init.c 
path_query.c 
tst_equery.c 
tst_tieetrace.c 
vpt_query.c 


A. 100  /cig/include/vpi_struct.h 

The  vpi_stmcth  file  defines  the  following  for  the  Viewport  Configuration  CSC: 

•  The  maximum  number  of  configuration  nodes  and  viewport  nodes. 

•  The  typedefs  for  the  RTS3x3_MTX,  RTS4x3_MTX,  and  ROT2xl  matrix 
stmctures. 

•  The  typedef  for  the  MTXUNION  stmcture. 

This  file  also  includes  standarcLh  and  def_mtx_type.h. 

Included  By:  be_stubs.c 

cnode_*.c  (all  files) 

dtp_*.c  (all  files) 

filLtree.c 

flagoff.c 

globs.c 

gosjocate.c 

init.free.c 

linkvpt.c 
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mkmtx_ntc 

mtx_*.c  (all  files) 

path.c 

path_imt.c 

path_query.c 

process_vppos.c 

real_tiinevpLh 

trav_tree.c 

tst_*.c  (all  files  except  tst_edebug.c) 

u_bnnask.c 

u_path.c 

u_rotations.c 

u_viewport.c 

u_xfrm.c 

update_mtx.c 

update_n)Lc 

vpLviewport.h 

vpt_*.c  (dl  files) 


A.  101  /cig/include/vpi_viewport.h 

The  vpi_viewporLh  file  defines  the  following  for  the  Viewport  Configuration  CSC; 

•  The  SUCCEED  and  FAIL  return  values. 

•  The  TORAD  and  toradians  macros  (described  in  Appendix  B). 

•  The  maximum  number  of  branch  values. 

•  The  typedefs  for  the  system  view  flags  and  the  view  positions  (vppos)  array 
structures. 

•  The  typedef  for  the  configuration  node,  viewport  parameters,  and  graphics  path 
parameters  structure. 

•  The  typedefs  for  the  fov  vector,  screen,  and  screen  constants  structures. 

This  file  also  includes  standard.h,  vpi_struct.h,  and  poly_struct.h. 

Included  By:  be_stubs.c 

cig_config.c 
cnode_*.c  (all  files) 
dtp_*.c  (all  files) 
filLtree.c 
flagoff.c 
globs.c 
gosjocate.c 
init_free.c 
linkvpt.c 
mtx_concaLc 
path.c 
pathJniLc 
path_query.c 
process_vflags.c 
process_vppos.c 
trav_tree.c 

tst_*.c  (all  files  except  tst_edebug.c) 
u_brmask.c 
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u_path.c 

u_rotations.c 

u_vie\vport.c 

u_xfrm.c 

update_mtx.c 

update_rot.c 

vpt_*.c  (all  files) 
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APPENDIX  B.  SYSTEM  MACROS 

Macros  are  used  throughout  the  system  to  perform  specialized  functions.  Most  of  the 
macros  that  are  used  by  more  than  one  function  are  defined  in  one  of  the  following  files: 

bx_inacros.h 

"Macros  used  exclusively  by  Ballistics. 

functions.h 

Macros  used  throughout  the  real-time  software. 

rcfuncs.c  and  rcinclude.h 

Macros  used  by  the  Runtime  Command  Library  (RCL)  and  the  DTP  Command 
Generator. 

rt_macros 

Macros  used  throughout  the  real-time  software. 

Macros  that  are  used  in  only  one  function  are  usually  defined  in  the  source  file  that  contains 
the  function. 

Although  some  macros  are  used  exclusively  in  one  area  of  the  system,  others  are  used  by 
multiple  CSCs.  For  easy  reference,  all  macros  are  described  in  this  appendix,  in 
alphabetical  order.  Each  macro's  description  specifies  where  the  macro  is  defined,  which 
functions  use  it,  what  routines  it  calls,  and  what  parameters  it  takes. 

In  section  2  of  this  document,  macros  are  treated  as  functions  —  i.e.,  if  a  function  uses  a 
macro,  the  macro  is  listed  in  the  function’s  Routines  Called  list. 


B .  1  AAMl_TO_AAM2 

The  AAMl_TO_AAM2  macro  determines  (using  AAM2_OFFSET)  the  location  in  active 
area  memory  in  backend  1  (AAM2)  that  corresponds  to  a  given  location  in  active  area 
memory  in  backend  0  (AAMl). 

The  usage  is  AAMl_TO_AAM2(addr),  where  addr  is  the  address  in  backend  O's  active 
area  memory.  ~ 


Defined  In:  kludge.h 

Called  By:  _handle_point_lights 

_update_second_active_area_memory 

Routines  Called:  none 


Parameters: 


INT_4 


addr 
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B.2  AAM2_ADDR 

The  AAM2_ADDR  macro  «n^D». 

The  usage  is  AAM2_ADDR(addr),  where  addr  is  «TBD» 


Defined  In:  functions.h 

process_vflags.c 


Called  By:  backend_set_color 

backend_set_thermal 
backend_update_view_paths 
cloud_mgmt 
cloud_up^te 
init_simulation 
process_vflags 


Routines  Called:  none 


Parameters:  INT_4 


addr 


B.3  AAREAD 

The  AAREAD  macro,  defined  in  defmitions.h,  is  not  currently  used. 


B.4  ABSVAL 

The  ABSVAL  macro,  defined  in  definitions.h  and  rt_macros.h,  is  not  currently  used. 


B.5  BCOPY 

The  BCOPY  macro  is  used  to  copy  a  specified  number  of  bytes.  The  usage  is 
BCOPY(source,  dest,  byte_count),  where: 

source  is  a  pointer  to  the  source  location 
dest  is  a  pointer  to  the  destination  location 
byte  count  is  the  number  of  bytes  to  be  copied 

BCOPY  passes  these  parameters  to  bcopy,  which  performs  the  copy.  The  BCOPY  macro 
has  been  retained  for  backward  compatibility. 


Defined  In:  mx_defines.h 
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Called  By: 


bO_add_static_vehicle 

bO_bal_config 

bO_bvol_entry 

bO_database_info 

bO_model_entry 

bx_chord_intersect 

download_bvols 

mx_push 


Routines  Called:  bcopy 


Parameters:  WORD 

WORD 
HWORD 


♦source 

*dest 

byte_count 


B.6  CHECK_FORCE 

The  CHECK_FORCE  macro  checks  to  see  if  the  Force  task  is  running  by  reading  the  ready 
bit  (roONT_RDY_MASK)  in  the  front-end  control  register  (FE_CONTROL).  If  Force  is 
running,  the  Gossip  operation  is  denied  and  the  user  is  asked  to  retry  later. 

The  usage  is  CHECK__FORCE. 


Defined  In: 

gos_120tx.c 

gos_mpv.c 

Called  By: 

gos_mpv 

Routines  Called: 

printf 

Parameters: 

none 

CHECKROT 

The  CHECKROT  macro  is  used  to  validate  rotation  values  for  Flea  vehicles.  Two  versions 
of  this  macro  exist. 

The  CHECKROT  macro  in  flea_simulate_vehicles.c  is  used  to  validate  the  rotation  value 
for  a  Flea  vehicle,  and  to  change  it  if  it  is  outside  the  range  0-360  degrees.  The  usage  is 
CHECKROT(x),  where  x  is  die  rotation  in  degrees.  If  x  is  greater  than  or  equal  to 
360.0,  CHECIGIOT  subtracts  360.0.  If  x  is  less  than  or  equal  to  360.0,  CHECKROT 
adds  360.0. 


Defined  In: 


flea  simulate_vehicles.c 
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Called  By:  flea_simulate_vehicles 


Routines  Called:  none 


Parameters:  «TBD» 


X 


The  CHECKROT  macro  in  flea_update_pos.c  is  used  to  validate  the  rotation  value  for  a 
Flea  vehicle.  The  usage  is  CHECKROT(rotation,  code),  where: 

rotation  is  the  rotation  in  degrees 

code  is  0  (flea_vprot.x),  1  (flea_vprot.y),  or  2  (flea_vprot.z) 

This  macro  is  called  after  flea_update_pos  has  already  added  360.0  if  the  rotation  value  is 
less  than  0.0,  or  subtracted  360.0  if  the  value  is  more  than  360.0.  If  the  rotation  is  still 
greater  than  360.0  or  less  than  0.0,  CHECKROT  outputs  an  error  and  sets  rotation  to  0.0. 
The  error  message  includes  the  code  to  identify  which  value  was  invalid. 


Defined  In: 

flea_update_pos.c 

Called  By: 

flea_update_pos 

Routines  Called: 

none 

Parameters: 

«TBD» 

rotation 

«TBD» 

code 

CUBE 

The  CUBE  macro,  defined  in  rt_macros.h,  is  not  currently  used. 


B.9  DART_ENQUEUE 

The  DART_ENQUEUE  macro,  defined  in  functions.h,  is  no  longer  used. 


B.IO  DED  BOUNDARY 

The  DED_BOUNDARY  macro  shifts  a  specified  number  of  words  from  a  specified 
location  to  the  shift  addr  passed  to  ded_model_trace  by  open_ded.  It  verifies  that  there  is 
room  to  shift  the  words,  does  the  move,  then  calls  PUSH_STACK  to  push  the  address 
onto  the  DED  model  trace  stack.  The  macro  outputs  a  status  message  when  it  performs  the 
shift,  or  an  error  if  there  is  not  enough  room. 

The  usage  is  DED_BOUNDARY(adr,  wc,  str),  where: 
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adr  is  the  command  address 

wc  is  the  number  of  words  to  be  moved 

str  is  a  string  to  be  output  to  identify  the  operation 


Defined  In:  ded_model_trace.c 


Called  By:  ded_model_trace 


Routines  Called:  printf 

PUSH_STACK 


Parameters:  INT_4  adr 

INT_4  wc 

char  str[] 


B.ll  DEGREE_TO_RADIAN 

The  DEGREE_TO_RADIAN  macro,  defined  in  rt_macros.h,  is  not  current  used. 


B.ll  DELETE_ROUND 

The  DELETE_ROUND  maao  is  used  by  Ballistics  to  remove  a  round  from  the  active  list 
and  put  it  on  the  free  list. 

The  usage  is  DELETE_ROUND(dead_round_P),  where  d'ad_round_P  is  a  pointer  to 
the  round  to  be  deleted.  ~  ~ 


Defined  In:  bx_macros.h 


Called  By:  bO_cancel_round 

bO_new_frame 
bO_process_round 
bO_round_fired 


Routines  Called:  none 


Parameters:  ROUND_DATA  *dead_round_P 


B.13  DELETE_STAT_VEH 

The  DELETE_STAT_VEH  macro  is  used  by  Ballistics  to  remove  a  static  vehicle  from  a 
load  module  list  and  put  it  on  the  free  list. 
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The  usage  is  DELETE_STAT_VEH(dead_sv_P,  tabIe_P),  where: 

dead  sv  P  is  a  pointer  to  the  static  vehicle  to  be  deleted 
table  P  is  a  pointer  to  the  vehicle  table 


Defined  In:  bx_macros.h 


Called  By:  bO_delete_static_vehicle 


Routines  Called:  none 


Parameters:  STAT_VEH 

STRUCT_P_SV 


B.14  DOWNLOAD_DATA 

The  DOWNLOAD_DATA  macro  downloads  2-D  overlay  data  into  GSP  memory.  This 
macro  is  used  by  linkup  to  download  the  2-D  overlays  after  they  are  generated  by  the  2-D 
overlay  compiler. 

The  usage  is  DOWNLOAD_DATA.  The  macro  does  the  following: 

•  Calls  the  WAIT.MPVIO  macro  to  wait  for  the  ready  bit  in  the  Force  front-end 
control  register  to  be  set,  indicating  that  the  MPV  is  ready  to  receive  data. 

•  Sets  the  GSP  addresses  in  the  MPV  mailbox. 

•  Copies  the  compiler  data  to  the  data_area. 

•  Sets  the  data_count  in  the  MPV  mailbox. 

•  Sets  the  Force  command  in  fe_control  to  SUBSYS_WRJ'lii_START. 


Defined  In:  cig_link_2d.c 


Called  By:  linkup 


Routines  Called:  WArr_MPVIO 


Parameters:  none 


B.15  dtp.*  (DTP  Macros) 

Macros  are  used  by  the  DTP  Command  Generator  functions  (and  some  testing  functions  in 
Gossip)  to  interface  to  the  Runtime  Command  Library  (RCL).  The  macros  call  RCL 
routines  to  generate  the  actual  commands  that  are  downloaded  to  the  hardware. 


*dead_sv_P 

*table_P 
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Each  DTP  hardware  command  has  one  or  more  supporting  macros.  The  macro  called  by 
the  DTP  Command  Generator  functions  depends  on  the  desired  command,  whether  a  label 
is  being  used,  and  whether  relative  or  absolute  addressing  is  being  used. 


The  following  table  lists  each  DTP  macro  and  identifies  its  parameters,  calling  routines,  and 
called  routines.  It  also  identifies  the  DTP  command  generated  by  RCL  for  each  macro. 
Detailed  descriptions  of  the  hardware  commands  are  beyond  the  scope  of  this  document. 


Eiefined  In:  icinclude.h 


Called  By: 


see  table  below 


Routines  Called:  see  table  below 

Parameters:  see  table  below 


Macro 

(parameters) 

DTP  Hardware 
Command  Generated 

Called 

By 

Routines 

Called 

dtp_bcn(label,  mask,  channel_data_offset) 

Branch  (Channel  Non¬ 
zero 

test_commands 

rcljblcmd 

dtp_bcnr(label,  mask,  channeLdata.offset) 

Branch  Channel  Non- 
Zero  Relative 

test_commands 

rcljblcmd 

dtp_bcnrs(aam_addtess,  mask, 
channel_data_offset) 

Branch  Channel  Non- 
Zero  Relative 

none 

rcLcoimnand 

dtp_bcns(aam_address,  mask, 
channel_data_offset) 

Branch  Channel  Non- 
Zero 

none 

rcLcommand 

dtp_bcz(label,  mask,  channel_data_offset) 

Branch  Channel  Zero 

test_commands 

rcMblcmd 

dtp_bc2T(label,  mask,  channel_data_offset) 

Branch  Channel  Zero 
Relative 

test_commands 

rcljblcmd 

dtp_bczrs(aam_address,  mask, 
channel_data_offset) 

Branch  Channel  Zero 
Relative 

none 

rcLcommand 

dq)_bczs(aam_address,  mask, 
channeLdata_ofTset) 

Branch  Channel  Zero 

none 

rcLconunand 

d^_bdgr(label,  cos_squared) 

Branch  DOT  Greater 

Than  Relative 

test_commands 

rcljblcmd 

d4)_bdgrs(pc_offset,  cos_squared) 

Branch  EXDT  Greater 

Than  Relative 

none 

rcLcommand 

dq)_bdlr(label,  cos.squaied) 

Branch  DOT  Less  Than 
Relative 

replace_mod, 

test_commands 

rcljblcmd 

dtp_bdlrs(pc_offset,  cos_squared) 

Branch  DOT  Less  Than 
Relative 

none 

rcLcommand 

dq3_bgn(label,  mask) 

Branch  Generic  Non- 
Zero 

test_commands 

rcljblcmd 
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dq)_bgns(aain_address,  mask) 

Branch  Generic  Non- 
Zero 

none 

rcLcommand 

dtp_bgz(label.  mask) 

Branch  Generic  Zero 

test_commands 

rcljblcmd 

dtp_bgzs(aam_addiess,  mask) 

Branch  Generic  Zero 

none 

rcLcomrrtand 

dq)_bbn(dtp_viewpoint_address, 
dtp_result_address,  x_multiplier, 
y_multiplier) 

Base  Load  Module 
Calculation 

dq)_trav2 

rcLcommand 

dq)_bnz(label,  mask,  dtp_addiess) 

Branch  Non-Zero 

dtp_travl, 

dtp_trav2, 

test_commands 

rcLlblcmd 

dtp_bnzr(1abel,  mask,  dtp_address) 

Branch  Non-Zero 

Relative 

test_commands 

rcljblcmd 

dtp_bnzrs(aam_address.  mask,  dtp.addiess) 

Branch  Non-Zero 

Relative 

none 

rcLcommand 

dtp_bnzs(aam_address,  mask,  d4)_addiess) 

Branch  Non-Zoo 

Relative 

none 

rcLcommand 

dtp.bpcO 

Bounding  Hane  Normals 
Calculation 

dtp_trav2 

rcLcommand 

d4)_l^x0 

Bounding  Hane  Normals 
Calculation  TX 

none 

rcLcommand 

dtp_bni(label) 

Branch  Unconditionally 

dtp_travl, 

di_trav2, 

replace_mod, 

test.commands 

rcljblcmd 

dtp_bnir(label) 

Branch  Unconditionally 
Relative 

test_commands 

rcljblcmd 

dtp_bruis(pc_offset) 

Branch  Unconditionally 

none 

rcLcommand 

dtp_brus(aam_address) 

Branch  Unconditionally 
Relative 

dtp_travl, 

d5)_trav2 

rcLcommand 

dtp_brz(label,  mask,  d^.address) 

Branch  Zero 

dtp_trav2, 

rq)lace_mod, 

test_commands 

rcljblcmd 

dtp_bizr(label,  mask,  dtp_address) 

Branch  Zero  Relative 

test_commands 

rcljblcmd 

dtp_brzrs(pc_offset,  mask,  dtp_addrcss) 

Branch  Zero  Relative 

none 

rcLcommand 

dtp_brzs(aam_address,  mask,  dtp.address) 

Branch  Zoo 

none 

rcLcommand 

dtp_dot(vx,  vy,  vz) 

DotPlroduct 

rq)lace_mod, 

test_commands 

rcLconunand 

d^_elmO 

End  Load  Module 

test.commands 

rcLcommand 

dq)_endO 

End  Current  Path 

dip_travl, 

dtp_trav2, 

test_commands 

rcLcommand 

dq)_fov(Iabel,  radius) 

Field  of  View  Test 

rcplace_mod, 

test_commands 

rcljblcmd 

dtp_fovr(label,  radius) 

Field  of  View  Test 
Relative 

test_commands 

rcljblcmd 

dtp_fovrs(pc_offset,  radius) 

Field  of  View  Test 
Relative 

none 

rcLcommand 
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d]p_fovs(aam_address,  radius) 

Field  of  View  Test 

none 

rcLcommand 

dtp_gdcGabel,  centroid_x,  ceniroid_y. 
centioid_z,  asid) 

Generic  Data  Call 

none 

rcLlblcmd 

dtp_gdci(label,  centtoid_x,  centroid_y, 
centioid_z,  asid,  dptr) 

Generic  Data  Call 

test_commands 

rcljblcmd 

dtp_gdcir(label,  centioid_x,  centroid_y, 
centroid_z,  asid,  dptr) 

Generic  Data  Call 
Relative 

none 

rcLlblcmd 

dtp_gdciis(aam_addiess,  centroid_x, 
centioid_y,  centroid_z,  asid,  <^tr) 

Generic  Data  Call 
Relative 

none 

rcLcommand 

dtp_gdcis(aani_addiess,  centroid_x, 
centroid_y,  centioid_z,  asid,  <^ptr) 

Generic  Data  Call 

ntme 

icLcranmand 

dtp_gdcn(label,  centroid_x,  centroid_y, 
centroid_z) 

Generic  Data  Call 

none 

rcljblcmd 

i 

dip_gdcnr(label,  centroid_x,  centioid_y, 
centtoid_z) 

Generic  Data  Call 
Relative 

nme 

rcLlblcmd 

dtp_gdcnrs(aain_address,  centrokl_x, 
centiDid_y,  centroid_z) 

Generic  Data  Call 
Relative 

none 

rcLcommand 

dtp_gdcns(aam_address,  centroid_x, 
centroid_y,  centroid_z) 

Generic  Data  Call 

none 

rcLcommand 

dtp_gdcr(label,  centioid_x,  centroid_y, 
centroid.z,  asid) 

Generic  Data  Call 
Relative 

tcst_cominands 

rcljblcmd 

dtp_gdcrs(aam_addiess,  centroid_x, 
centroid_y,  centroid_z,  asid) 

Generic  Data  Call 
Relative 

none 

rcLcommand 

dq) _gdcs(aam_address,  centroid_x, 
centroid_y,  centroid_z,  asid) 

Generic  Data  Call 

none 

rcLcommand 

dtp_gr(offsei) 

Generic  Return 

outahere, 

rq)lace_mod, 

tesLcommands 

rcLcommand 

dlp_lini(label,  radius) 

Load  Module  In  Field  of 
View  Test 

tesLcommands 

rcljblcmd 

dtp_lmir(label,  radius) 

Load  Module  In  Field  of 
View  Test  Relative 

test_conimands 

rcljblcmd 

dtp_ltnirs(pc_offset,  radius) 

Load  Module  In  Field  of 
View  Test  Relative 

none 

rcLcommand 

dtp_lmis(aain_address,  radius) 

Load  Module  In  Field  of 
View  Test 

none 

rcLcommand 

d4>_lodGabel,  range_squared) 

Level  of  Detail  Test 

rq)lace_mod, 

test_commands 

rcljblcmd 

dtpJodrOabel,  range_squared) 

Level  of  Detail  Test 
Relative 

test_commands 

rcljblcmd 

dtp_lodrs(pc_offset,  range_squared) 

Level  of  Detail  Test 
Relative 

none 

rcLcommand 

dip_iods(aain_addiess,  range_squared) 

Level  of  Detail  Test 

none 

rcLcommand 

d4)Jwd(label,  dtp_addiess,  word_count) 

Load  Words 

dtp_travl, 

tesLcommands 

rcljblcmd 

d4)Jwdr(label.  dtp_address,  word.count) 

Load  Words  Relative 

none 

rcljblcmd 
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dlp_lwdrs(pc_offset,  dtp.addiess, 
word_count) 

Load  Words  Relative 

none 

rcLcommand 

dtp_Iwds(aani_ad(iress,  dtp_address, 
w<ad_count) 

Load  Words 

dqj_travl, 

dtp_trav2 

rcLcommand 

djp_minl(dtp_address_a,  dip_address_b, 
dip_address_c) 

Matrix  Multiply  Local 
(A*B=>0 

none 

rcLcommand 

dq)_niinpre(d^_address_a,  dtp_address_b. 
dip_addi^_c) 

Matrix  Multiply  Pre 
(A*B=>Q 

none 

rcLcommand 

dtp_ininpst(dtp_address_a,  dtp_address_b, 
dtp_addi^_c) 

Matrix  Multiply  Post 
(A*B=>Q 

S! 

tt 

rcLcommand 

dip_mwd(dtp_address_a,  dtp_addrcss_b. 
word_counl) 

Move  Wwds 

dtp_travl 

rcLcommand 

dtp_ngc(centroid_x,  centroid_y,  centroid_z) 

Non-Generic  Centroid 

test_commands 

rcLcommand 

d^_oio(ou^ut_offset,  word_count) 

Ou^ut  Indirect  Offset 

test_commands 

rcLcommand 

dtp_oos(ou^ut_offset,  word_count, 
stack_offset) 

Ouqrut  Offset  Stack 

test_commands 

rcLcommand 

d4)_osd(label) 

Output  Single  Word 
Direct 

dtp_trav2 

rcljblcmd 

dq)_osds(aam_address) 

Output  Single  Word 
Direct 

none 

rcLcommand 

dtp_owd(label,  word_count) 

Output  WOTds  Direct 

dtp_trav2, 

outahere, 

rq)lace_mod, 

test.commands 

rcljblcmd 

dtp_owds(aam_address,  word_count) 

Output  Words  Direct 

dlp_trav2 

rcLcommand 

dtp_owdsc(label,  end_label) 

Output  Words  Direct  - 
Set  Count 

outahere, 

test_commands 

rcljblcmd 

dtp_owo{aam_address_offset,  word_count) 

Output  Words  Offset 

rq)lace_mod, 

tesi_commands 

rcLcommand 

dtp_owr(label,  wOTd_count) 

Output  Words  Relative 

test_commands 

rcljblcmd 

d5)_owrs(pc_offset,  word_counl) 

Output  Words  Relative 

none 

rcLcommand 

dtp_owrsc(label,  end_label) 

Output  Words  Relative  - 
Set  Count 

none 

rcljblcmd 

d?)_rcO 

Range  Calculation 

tq)lace_mod, 

test_commands 

rcLcommand 

d5)_sub(label) 

Subroutine  Call 

rq)lace_mod, 

test_commands 

rcljblcmd 

dtp_subr(label) 

Subroutine  Call  Relative 

test_commands 

rcljblcmd 

d4)_sul»s(pc_offset) 

Subroutine  Call  Relative 

none 

rcLcommand 

dtp_subs(aam_address) 

Subroutine  Call 

dtp_trav2 

rcLcommand 

dtp_tbc(totaI_time) 

Time  Base  Calculation 

replace_mod, 

test_commands 

rcLcommand 

dtp_tbdr(label,  start_time,  end_time) 

Time  Base  Data  Relative 

rq)lacc_mod, 

test_commands 

rcljblcmd 

dtp_lbdrs(pc_offset,  siart_time,  end_time) 

Time  Base  Data  Relative 

none 

rcLcommand 
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dtp_tbiT(label,  maximuin_time) 

Time  Branch  Relative 

iq)lace_mod, 

test.commands 

itLlblcmd 

dtp_tbrrs(pc_offset,  maximuin_tiine) 

Time  Bnmch  Relative 

ncxie 

icLcommand 

B.16  DUMP_DART_B UPPER 

The  DUMP_DART_BUFFER  macro,  defined  in  functions.h,  is  no  longer  used. 


B.17  ERRMSG 

The  ERRMSG  macro  prints  an  error  for  the  Runtime  Command  Library  (RCL)  functions. 
The  usage  is  ERRMSG(a,  b),  where: 

a  is  the  error  message  text 
b  is  the  name  of  the  calling  routine 


Defined  In: 


rcfuncs.c 


Called  By:  rcl_patch_adrs 

rcLpop 
tcLpush 
rcl_set_cntlbl 
rcLsetJabel 


Routines  Called: 

printf 

Parameters: 

char 

a[] 

char 

b[] 

B.18  EXCHANGE_PLEA_DATA 

The  EXCHANGE_FLEA_DATA  macro  is  used  by  Flea  to  exchange  message  packets  with 
the  real-time  software.  It  generates  the  MSG_END  message  and  the  message  header,  posts 
a  message  to  the  FLEA_I]^UT_MB  mailbox,  then  waits  for  a  message  to  be  posted  to  the 
FLEA_OUTPUT_MB  mailbox. 

The  usage  is  EXCHANGE_FLEA_DATA(fIea_imsg,  fIea_omsg),  where: 

flea  imsg  is  a  pointer  to  the  Flea-to-CIG  message  packet 
flea  omsg  is  a  pointer  to  the  CIG-to-Flea  message  packet 


Defined  In:  functions.h 

Called  By:  flea 
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flea_init_cig_sw 


Routines  Called:  sc_pend 

sc_post 


Parameters:  INT_4  *flea_imsg 

INT_4  *flea_omsg 


B.19  FIND_LM 

The  FIND_LM  macro  finds  the  load  module  that  a  given  x,  y  location  lies  in.  It  is  assumed 
that  the  point  is  within  active  area  memory. 

The  usage  is  FIND_LM(x,  y,  Im,  inv_width,  mask,  num_per_side),  where: 

X  is  the  location's  x  coordinate 

y  is  the  location's  y  coordinate 

Im  is  the  number  of  the  load  module 

inv  width  is  the  inverse  of  the  width  of  a  load  module 

mask  is  the  mask  of  the  number  of  load  module  blocks  per  side 

num _per_side  is  the  number  of  load  modules  per  side  of  AAM 


Defined  In: 

functions.h 

rt_macros.h 

Called  By: 

bal_get_db_pos 

ball_effect_add 

bx_probe 

gos_bal_query 

otherveh_state 

show_effect_msg 

staticveh_remove 

staticveh_state 

Routines  Called: 

none 

Paran'eters: 

INT  4 

X 

INT  4 

y 

INT  4 

Im 

REAL  4 

inv_width 

INT  4 

mask 

HWORD 

num_per_side 

B.20  FLTOFX 

The  PT.TOFX  macro,  defined  in  rt_macros.h,  is  no  longer  used. 
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B.21  FREE_LM_CACHE 

The  FREE_LM_CACHE  macro,  when  given  a  load  module  in  the  Ballistics  database 
cache,  puts  the  bounding  volumes  in  that  load  module  on  the  free  bvol  list,  and  puts  the 
polygons  in  that  load  module  on  the  free  polygon  lists. 

The  usage  is  FREE_LM_CACHE(lm_dir),  where  Im  dir  is  a  load  module  in  the  cache. 


Defined  In:  bx_macros.h 


Called  By:  bO_lm_read 

bx_new_bvol 
bx_new_poly 


Routines  Called:  none 


Parameters:  LM_CACHE_ENTRY  *lm_dir 


B.22  FXT0881 

The  FXT0881  macro  converts  a  fixed  value  to  floating  point.  The  usage  is 
FXT0881(fxd,  nt,  bits),  where: 

fxd  is  the  fixed  point  value  to  be  converted 

fit  is  the  floating  point  value  (result) 

bits  is  the  number  of  fractional  bits  in  the  fixed  point  number 


Defined  In: 

functions.h 

rt_macros.h 

Called  By: 

bx_get_lm_data 

csifa_laser_retum 

fxbvtofl 

fxbvtofl_020 

fxbvtofl_dart 

locaLterrain 

mpvideo_response 

Routines  Called: 

none 

Parameters: 

INT  2 

fxd 

REAL  4 

fit 

INT  4 

bits 
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B.23  FXTOFL 

The  FXTOFL  macro,  defined  in  rt_macros.h,  is  no  longer  used. 


B.24  GET_CHORD_END 

The  GET_CHORD_END  macro,  defined  in  bx_macros.h,  is  not  currently  used. 


B.25  GET_DB_POS 

The  GET_DB_POS  macro  is  used  by  Ballistics  to  find  the  load  module  that  corresponds  to 
a  given  point  in  the  database. 

The  usage  is  GET_DB_POS(point_P,  lin_width,  inv_lm_width,  Im  per  side), 
where: 

point  P  is  a  pointer  to  the  location  in  the  database 

lm_width  is  the  width  of  a  load  module 

inv_lm_width  is  inverse  of  the  width  of  a  load  module 

Im _per_side  is  the  number  of  load  modules  in  a  row  or  column  of  AAM 


Defined  In: 

bx_macros.h 

Called  By; 

bO_process_chord 

bO_tf_vehicle_pos 

bO_traj_chord 

bx_trajectory 

Routines  Called: 

none 

Parameters: 

POINT  DATA 

*point_P 

HWORD 

lm_width 

REAL  4 

inv_lm_width 

HWORD 

lm_per_side 

B.26  GET_LB_FROM_LM 

The  GET_LB_FROM_LM  macro  is  used  by  Ballistics  to  take  a  load  module  number  and 
calculate  the  number  of  the  load  block  that  module  is  in. 

The  usage  is  GET_LB_FROM_LM(lin,  Ib),  where; 

Im  is  the  load  module  number  (0  to  1023) 
lb  is  the  load  block  number  (0  to  255) 
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Defined  In: 


bx_macros.h 


Called  By:  bO_process_chord 

bO_round_fired 

bx_chord_intersect 

bx_round_tracer_position 


Routines  Called:  none 


Parameters:  INT_4 

INT_4 


Im 

lb 


B.27  GLOB 

The  GLOB  macro  has  no  effect  —  GLOB(x)  is  defined  as  x.  This  macro  was  required  in 
an  earlier  implementation  to  access  global  memory  on  a  specific  platform. 


Defined  In:  ememory_map.h 

memory_map.h 


Called  By:  _rowcoI_rd 

autopilot 
bal_buffer_setup 
bx_task 
cal 

cig_config 

cloud_init 

cloud_mgmt 

cloud_placement 

cloud_update 

config_ballistics 

db_mcc_setup 

dtp_emu 

file_control 

flea_atp 

flea_bal_opts 

flea _graphics_test 

flea_init_cig_sw 

flea_switches 

flea_veh_control 

get_tx_lut_index 

getside 

gos_120tx 

gos_model 

gos_mpvio 

gos_system 

host_if_debug_tick 
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hw_test 

load_modules 

local„terrain 

mcxlel_mtx 

msg_calibration_image 
msg_cig_ctl 
msg_drl  l_pkt_size 
open_dbase 
process_a_msg 

sim_bal_*  (all  functions  except  sim_bal_init) 

simulation 

tick 

update_2d 

upstart 


Routines  Called:  none 


Parameters;  none 


B.28  INCR  COMPONENT 

The  INCR_COMPONENT  macro  is  used  by  the  Runtime  Command  Library  functions  to 
update  a  component's  word  count,  polygon  count,  and  vertex  count. 

The  usage  is  INCR_COMPONENT(incr),  where  incr  is  the  count  increment. 


Defined  In: 
Called  By: 

Routines  Called: 

Parameters; 


rcfuncs.c 

rcl_component 

rcLdata 

none 

WORD 


incr 


B.29  INIT_MTX 

The  INIT_MTX  macro  initializes  a  4x3  matrix  to  the  identity  matrix.  The  last  column  is 
assumed  and  zeroes  are  assumed  loaded.  This  routine  is  used  to  initialize  the  matrices  for 
all  static  and  dynamic  vehicles  on  start-up. 

The  usage  is  INIT_MTX(matrix),  where  matrix  is  the  model's  transformation  matrix. 


Defined  In:  functions.h 

rt  macros.h 
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Called  By:  cloud_init 

dl_setup 


Routines  Called:  none 


Parameters:  REAL_4 


matrix 


B.30  MAGSQ2D 

The  MAGSQ2D  macro,  defined  in  rt_macros.h,  is  not  currently  used. 


B.31  MAGSQ3D 

The  MAGSQ3D  macro,  defined  in  rt_macros.h,  is  not  currently  used. 


B.32  MALLOC 

The  MALLOC  macro  is  used  to  allocate  memory  for  Balhstics  structures.  MALLOC  calls 
slavel33_malloc  if  Ballistics  is  running  on  a  slave  board;  otherwise  it  calls  the  standard 
malloc  routine. 

The  usage  is  MALLOC(size),  where  size  is  the  amount  of  memory  to  be  allocated. 


Defined  In:  bx_defines.h 

Called  By:  bO_add_traj_table 

bO_database_info 


Routines  Called:  malloc 

slavel33_malloc 


Parameters:  int 


size 


B.33  MAX 

The  MAX  macro,  defined  in  rt_macros.h,  is  not  currently  used. 


B.34  MIN 

The  MIN  macro,  defined  in  rt_macros.h,  is  not  currently  used. 


782 


BBN  Systems  and  Technologies 


GTIOO  RTSW  CSCI 


B.35  NEW_ROUND 

The  NEW_ROUND  macro  is  used  by  Ballistics  to  get  a  new  round  from  the  free  list  and 
set  a  pointer  to  it. 

The  usage  is  NEW_ROUND(new_round_P),  where  new  round  P  is  the  pointer  for 
the  ntw  round. 

Defined  In:  bx_macros.h 

Called  By:  bO_process_round 

bO_round_fired 

Routines  Called:  none 

Parameters:  ROUND_DATA  *new_round_P 

B.36  NEW_STAT_VEH 

The  NEW_STAT_VEH  macro  is  used  by  Ballistics  to  get  a  static  vehicle  from  the  free  list 
and  put  it  in  the  vehicle  table  list  of  a  specified  load  module. 

The  usage  is  NEWEST AT_VEH  (veh_tabIe_P,  new_sv_^P),  where: 

veh  jable  P  is  a  pointer  to  the  vehicle  table 
new_sv_P  is  the  pointer  to  the  new  vehicle 

new_sv_P  is  set  to  NULL  if  no  pointers  are  available  (i.e.,  the  maximum  number  of  static 
vehicles  has  been  reached). 

Defined  In:  bx_macros.h 

Called  By:  bO_add_static_vehicle 

Routines  Called:  none 

Parameters:  STRUCT_P_SV 

STAT.VEH 


*veh_table_P 
*new  sv  P 
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B.37  OPEN_FLEA_DATA 

The  OPEN_FLEA_DATA  macro  is  used  by  Flea  to  obtain  the  file  descriptors  for  the  input 
and  output  channels  for  Flea-CIG  communications.  The  macro  waits  for  a  message  to  be 
posted  to  the  FLEA_OUTPUT_MB  mailbox,  than  sets  pointers  to  the  input  and  output 
packet  buffers. 

The  usage  is  OPEN_FLEA_DATA(input_ptr,  output_ptr),  where: 

input _ptr  is  a  pointer  to  the  Flea-to-CIG  message  packet  buffer 
output _ptr  is  a  pointer  to  the  CIG-to-Flea  message  packet  buffer 


Defined  In: 

functions.h 

Called  By: 

flea 

Routines  Called: 

sc_pend 

Parameters: 

INT  4 

INT_4 

*input_ptr 

*output_ptr 


B.38  OUTPUT_MESSAGE 

The  OUTPUT_MESSAGE  macro,  used  by  Flea,  copies  messages  and  message  headers  to 
the  output  message  buffer.  This  macro  is  defined  and  used  in  two  different  places. 

The  OUTPUT_MESSAGE  macro  defined  in  cf_translator.c  is  used  by  config_translator 
and  the  process_*  functions  to  copy  messages  to  a  temporary  message  buffer 
(output_msg_buffer).  The  usage  is  OUTPUT_MESSAGE(message),  where  message 
is  the  message  or  message  header  to  be  copied.  The  macro  also  keeps  track  of  the  size  of 
the  output  message  buffer. 


Defined  In:  cf_translator.c 


Called  By:  config_translator 

process_2d_setup 
process_2d_setup 
process_add_traj_.table 
process_agl_setup 
process_ammo_defuie 
process_cig_ctl 
process_configtrce_node 
process_define_tx_mode 
process_drl  I_pkt_size 
process_file_description 
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pnx;ess_lt_state 

process_lt_state 

process_overlay_setup 

process_ppm_display_mode 

process_ppm_display_off set 

process_ppm_pixel_location 

process_ppm_pixel_state 

process_sio_close 

process_sio_init 

process_tf_init_hdr 

process_tf_init_pt 

process_tf_state 

process_traj_entry 

process_viewport_state 


Routines  Called:  bcopy 

Parameters;  <message  structure>  message 


The  OUTPUT_MESSAGE  macro  defined  in  flea_init_cig_sw  is  used  by  that  function  to 
copy  messages  from  the  temporary  buffer  (config_msgs_P)  to  the  message  packet 
(fleajmsg)  that  will  be  sent  to  the  real-time  software  at  the  next  exchange.  The  macro 
calculates  Ae  size  of  each  message  it  adds  and  increments  the  packet  size  accordingly. 

The  usage  is  OUTPUT_MESSAGE(message_structure),  where  message _structure 
is  the  message  structure  to  be  copied.  ~ 


Defined  In: 
CaUed  By: 
Routines  Called: 

Parameters: 


flea_init_cig_sw.c 

flea_init_cig_sw 

bcopy 

<message  structure> 


message_structure 


B.39  PAGE_FORMAT 

The  PAGE_FORMAT  macro  is  used  by  the  Ballistics  portion  of  Gossip  to  handle  displays 
that  exceed  one  page  (16  lines). 

The  usage  is  PAGE_FORMAT(lines),  where  lines  is  the  number  of  lines  in  the  display. 


Defined  In;  bx_probe.c 

gos_bal_queiy.c 
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Called  By;  bx_probe 

gos_bal_query 


Routines  Called:  printf 

scanf 


Parameters:  INT  lines 


B.40  poly.*  (Poly  Processor  Macros) 

Macros  are  used  by  the  DTP  Command  Generator  functions  (and  some  testing  functions  in 
Gossip)  to  interface  to  the  Runtime  Command  Library  (RCL).  These  macros  call  RCL 
routines  that  generate  the  actual  commands  that  are  downloaded  to  the  Polygon  Processor. 

Each  Poly  Processor  command  has  one  or  more  supporting  macros.  The  following  table 
lists  each  Poly  Processor  macro  and  identifies  its  parameters,  calling  routines,  and  called 
routines.  It  also  identifies  the  Poly  Processor  command  generated  by  RCL  for  each  macro. 
Detailed  descriptions  of  the  hardware  commands  are  beyond  the  scope  of  this  document. 


Defined  In: 

rcinclude.h 

CaUed  By: 

see  uble  below 

Routines  Called: 

see  table  below 

Parameters; 

see  table  below 
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Macro 

(parameters) 

Poly  Processor 
Command  Generated 

Called 

By 

Routines 

Called 

poly_ab(alpha_0,  beta_0,  alpha_l,  beta_l) 

Alpha  Betas 

none 

rcLdata 

poIy_bvc(ballistics_bit,  local_tenain_biO 

Bounding  Volume 
Component 

none 

rcl_component 

poly_efs(label,  number_of_firames) 

Effect  Stage 

none 

icljblcmd 

poly_efsr(label,  number_of_frames) 

Effect  Stage  Relative 

none 

rcljblcmd 

poly_fluO 

Rush 

dtp_travl, 

test.commands 

rcl_command 

poly_fswO 

Fom  Stamp  Words 

dtp_trav2 

rcLcommand 

poly_gc(ballistics_bit,  local_terTain_bit) 

Grid  Component 

none 

rcl_component 

poly_inf(infonnation_word) 

Info  Word 

double_lite, 

singlejite, 

test_commands, 

triplejite, 

vasijite 

rcLdata 

poly_lmf(matrix_pointer) 

Load  Matrix  Full 

none 

rcLcommand, 

rcLstuff_daia 

poly_lsc(x,  y,  z,  w) 

Load  Screen  Constants 

none 

rcLcommand 

poly_mmf(matrix_pointer) 

Matrix  Multiply  Full 

iq)lace_mod, 

tcst_commands 

rcLcommand, 

rcLstuff_data 

poly_pc(ballistics_biti  local_terrain_bit) 

Poly  Component 

double_lite, 

singlejite, 

test_commands, 

triplejite, 

vasijite 

rcLcomponent 

poly_poly(poly_info_word,  veitexjist, 
alpha,  beta) 

Polygon  Enuy 

none 

rcLdata 

poly_nnlO 

Recall  Matrix  1 

dtp_trav2, 

rq)lace_mod, 

test_commands 

rcLcommand 

poly_rm20 

Recall  Matrix  2 

none 

rcLcommand 

poly_nn30 

Recall  Matrix  3 

none 

rcLcommand 

poly_nn40 

Recall  Matrix  4 

none 

rcLcommand 

poly_sc(ballistics_bit.  local_terrain_bit) 

Stamp  Component 

none 

rcLcomponent 

poly_sci(ballistics_bit.  local_terrain_bit, 
stamp_info_word,  stamp_half_width, 
stamp_height) 

Stamp  Component 
Incomplete 

none 

rcLcomponent, 

rcLdata 

poly_sec(ballistics_btt.  locaI_terrain_bit) 

Special  Effect 

Component 

none 

rcLcomponent 

poly_smlO 

Save  Matrix  1 

dtp_trav2 

rcLcommand 

poly_sm20 

Save  Matrix  2 

none 

rcLcommand 

poly_sm30 

Save  Matrix  3 

none 

rcLcommand 

poly_sni40 

Save  Matrix  4 

none 

rcLcommand 
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poly_stamp(stamp_info_woid, 
stamp_half_width„  stamp_height, 
stamp_center_x,  stamp_center_y. 
stamp_center_z) 

Stamp  List  Entry 

none 

icljdata 

poly_togO 

Channel  Toggle 

rcl_command 

poly_vtxe(x_value,  y_value,  z_value) 

Vertex  List  Entry 

double_lite, 

singlc_lite, 

test.commands, 

triplejite, 

vasijite 

icljdata 

poly_vtxl(index_0,  index_l.  index_2, 
index_3) 

Vertex  List 

double_lite, 

single_lite, 

test_c(Mnmands, 

triplejite, 

vasijite 

icLdata 

B.41  POP_STACK 

The  POP_STACK  macro  pops  the  next  address  off  the  DED  model  trace  stack.  The 
address  is  set  to  0  if  the  stack  is  empty. 

The  usage  is  POP_STACK. 


Defined  In: 
Called  By: 
Routines  Called: 

Parameters: 


ded_model_trace.c 

ded_model_trace 


none 


none 


B.42  PRINTD4 

The  PRINTD4  macro  prints  a  32-bit  word  in  hexadecimal  and  decimal  format.  The  address 
at  which  to  start  printing  is  in  the  pointer  variable  pntrl. 

The  usage  is  PRINTD4(). 


Defined  In: 
CaUed  By: 
Routines  Called: 


gos_memory.c 

gos_memory 

printf 
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Parameters: 


none 


B.43  PRINTD8 

The  PRINTD8  macro  prints  a  double  in  hexadecimal  and  decimal  format.  The  address  at 
which  to  start  printing  is  in  the  pointer  variable  pntrl. 

The  usage  is  PRINTD8(). 

E>efined  In:  gos_memory.c 

Called  By:  gos_memory 

Routines  Called:  printf 

Parameters:  none 


B.44  PRINTHEX4 

The  PRINTHEX4  macro  prints  a  32-bit  word  in  hexadecimal  format.  The  address  at 
which  to  start  printing  is  in  the  pointer  variable  pntr2. 

The  usage  is  PRINTHEX4(). 


Defined  In: 


Called  By: 


gos_memory.c 


gos_memory 


Routines  Called:  printf 


Parameters: 


none 


B.45  PRINTHEX8 

The  PRINTHEX8  macro  prints  a  64-bit  word  in  hexadecimal  format  The  address  at 
which  to  start  printing  is  in  the  pointer  variable  prar2. 

The  usage  is  PRINTHEX8(). 


Defined  In: 


gos_memory.c 
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Called  By:  gos_memory 

Routines  Called:  printf 

Parameters:  none 

B.46  PUSH_STACK 

The  PUSH_STACK  macro  pushes  an  address  onto  the  DED  model  trace  stack,  if  there  is 
room  left  in  the  stack. 

The  usage  is  PUSH_STACK(adr),  where  adr  is  the  address  to  be  added  to  the  stack. 
Defined  In:  ded_model_trace.c 

Called  By:  DED.BOUNDARY 

Routines  Called:  none 

Parameters:  INT_4  adr 

B.47  RADIAN_TO_DEGREE 

The  RADIAN_TO_DEGREE  macro,  defined  in  rt_macros.h,  is  not  currently  used. 

B.48  ROOM4LABEL 

The  ROOM4LABEL  macro  verifies  that  there  is  room  in  the  RCL  stack  to  add  a  label.  If 
the  stack  does  not  have  room  for  the  label,  the  macro  outputs  an  error. 

The  usage  is  ROOM4LABEL(store,  loc),  where: 

store  is  the  location  to  store  the  address 
loc  is  the  label  to  set  with  the  AAM  location 

Defined  In:  rcfuncs.c 

Called  By:  rcljblcmd 

rcl_set_cntlbl 

rcl_set_label 
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Routines  Called:  ERRMSG 

printf 


Parameters:  WORD  *  store 

WORD  m 


B.49  ROOMCHECK 

The  ROOMCHECK  macro  verifies  that  there  is  enough  space  for  a  new  RCL  command. 
The  usage  is  ROOMCHECK(name,  wd_cnt),  wh^ere: 

name  is  a  pointer  to  the  routine  name 
wd  cnt  is  the  number  of  command  WORDs 

The  function  outputs  an  error  if  space  is  insufficient. 


Defined  In:  rcfuncs.c 


Called  By:  rcLcommand 

rcl_component 
rcLlblcmd 


Routines  Called:  ERRMSG 


Parameters:  char 

WORD 


B.50  SEND_TF_INFO 

The  SEND_TF_INFO  macro  generates  MSG_T^_HDR  (terrain  feedback  header)  and 
MSG_TF_PT  (terrain  feedback  point)  messages,  and  puts  them  in  the  outgoing  message 
packet.  The  usage  is  SEND_TF_INFO(). 


Defined  In:  bal_routines.c 


Called  By:  sim_bal_process_msg 


Routines  Called:  none 


Parameters:  none 


*name 
wd  cnt 
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B.51  SET_OUT_BITS 

The  SET_OUT_BITS  macro,  defined  in  definitions.h,  is  not  currently  used. 


B.52  SET_OUT_M2BITS 

The  SET_OUT_M2BITS  macro,  defined  in  definitions.h,  is  not  currently  used. 


B.53  SET_PPM_DISPLAY_OFFSET 

The  SET_PPM_DISPLAY_OFFSET  macro  puts  new  PPM  display  offset  values  into  the 
Flea  output  work  buffer  (p_flea_out).  It  also  adjusts  the  values  if  out  of  range.  After 
setting  the  new  values,  it  sets  ppm_display_offset_flag  in  p_flea_out  to  TRUE. 

The  usage  is  SET_PPM_DISPLAY_OFFSET(). 


Defined  In: 

tick_ppm.c 

Called  By; 

tick_ppm 

Routines  Called: 

none 

Parameters: 

none 

B.54  SET_PPM_PIXEL_LOCATION 

The  SET_PPM„PIXEL_LOCATION  macro  puts  new  PPM  pixel  location  values  into  the 
Flea  output  work  buffer  (p_flea_out).  It  also  adjusts  the  values  if  out  of  range.  After 
setting  the  new  values,  it  sets  ppm_pixel_location_flag  in  p_flea_out  to  TRUE. 

The  usage  is  SET_PPM_PIXEL_LOCATION(). 


Defined  In: 

tick_ppm.c 

Called  By; 

tick_ppm 

Routines  Called: 

none 

Parameters: 

none 
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B.55  SIGN 

The  SIGN  macro,  defined  in  rt_macros.h,  is  not  currently  used. 


B.56  SQUARE 

The  SQUARE  macro,  defined  in  rt_macros.h,  is  not  currently  used. 


B.57  SYSERR 

The  SYSERR  macro  adds  a  MSG_SYS_ERROR  message  to  the  output  buffer  and  ends 
processing  of  input  messages  by  pointing  to  a  dummy  end  statement. 

The  usage  is  SYSERR(error,  state),  where: 

error  is  the  error  message 
state  is  the  current  state  of  the  CIG 


Defined  In:  functions.h 


Called  By:  db_mcc_setup 

exchange_flea_data 

exchange_scsi_data 

exchange_scsi_data_sim 

file_controI. 

get_msg_2d 

hw_test 

open_dbase 

upstart 


Routines  Called:  none 


Parameters:  INT_2 

INT_2 


error 

state 


B.58  TODEG 

The  TODEG  macro  converts  an  angle  from  radians  to  degrees  by  multiplying  the  given 
value  by  57.29578122. 

The  usage  is  TODEG(angle),  where  angle  is  the  angle  in  radians  to  be  converted. 
Defined  In:  flea_simulate_vehicles.c 
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Called  By:  fmd_pitch_and_roll 

Routines  Called:  none 

Parameters:  REAL_4  angle 

B.59  TORAD 

The  TORAD  macro  converts  an  angle  from  degrees  to  radians  by  multiplying  the  given 
value  by  0.017453292. 

The  usage  is  TORAD(angle),  where  angle  is  the  angle  in  degrees  to  be  converted. 


Defined  In:  autopilot.c 

dynamic_demo.c 

encode_routines.c 

flea_agl_terrain_follow  .c 

flea_agpt_switchv^s.c 

flea_bd_opts.c 

flea_db_traverse.c 

flea_decode_data.c 

flea_init_cig_sw.c 

flea_ppm_obj.c 

flea_script.c 

flea_simulate_vehicles.c 

flea_switches.c 

flea_update_pos.c 

flea_veh_control.c 

gos_model.c 

rt_macros.h 

tick_ppm.c 

tick_script.c 

update_2d.c 

update_agpt_2d.c 

vpi_viewport.h 


Called  By:  autopilot 

dynamic_demo 

flea_init_cig_sw 

flea_simulate_vehicles 

flea_update_pos 

gos_model 

mtx_concat 

send_gun_overlay 

tst_eupdate 

upd_rotation_values 

vpt_path_process 

vpt_path_update 
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vpt_update 


Routines  Called:  none 


Parameters:  INT 


angle 


B.60  toradians 

The  toradians  macro  converts  an  angle  into  radians.  The  usage  is  toradians(angle).  The 
routine  multiplies  the  given  angle  by  0.017453293. 


Defined  In:  dig_defines.h 

make_bbn.c 
mkmtx_nt.c 
model_mtx.c 
vpi_viewport.h 


Called  By: 


rotate_x 
rotate _y 
rotate  z 


Routines  Called:  none 


Parameters:  INT  angle 

B.61  TRIGGER_FORCE 

The  TRIGGER_FORCE  macro,  defined  in  functions.h,  is  no  longer  used. 


B.62  VME_TO_VMX 

The  VME_TO_VMX  macro  converts  a  VME  address  to  a  VMX  address.  The  usage  is 
VME_TO  VMX(addr),  where  addr  is  the  VME  address  to  be  converted. 


Defined  In:  cal.c 

kludge.h 

msg_calibration_image.c 

msg_effect.c 

msg_veh_state.c 


Called  By: 

I  - 


cal 

msg_cali  brationjmage 
msg_otherveh_state 
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msg_show_effect 

msg_staticveh_rem 

msg_staticveh_state 


Routines  Called:  none 

Parameters:  INT_4  addr 

B.63  WAIT_FORCE 

The  WAIT_FORCE  macro,  defined  in  functions.h,  is  no  longer  used. 


B.64  WAIT_MPVIO 

The  WAIT_MPVIO  macro  waits  until  the  ready  bit  (FRONT_RDY_MASK)  in  the  Force 
front-end  control  register  is  set,  indicating  that  the  MPV  is  ready  to  receive  data.  The 
macro  outputs  a  message  every  50,000  attempts.  When  the  ready  bit  is  set,  the  calling 
function  continues  processing. 

The  usage  is  WAIT_MPVIO(pmbx),  where  pmbx  is  a  pointer  to  the  MPV  I/O  interface 
mailbox.  ” 


Defined  In: 


mpvideo.h 


Called  By: 


DOWNLOAD_DATA 

mpvideo_boot 

mpvideojoad 

mpvideo_sim_init 


Routines  Called:  printf 


Parameters: 


MPVIO  INTERFACE 


'‘pmbx 


B.65  WAIT_MPVREPLY 

The  WAIT_MPVREPLY  macro  waits  for  a  message  to  be  placed  in  the  mpvio_from_buf 
message  buffer.  The  macro  uses  mx2_peek  to  check  the  buffer.  When  the  status  returned 
from  mx2_peek  is  MX_MESSAGE_PREVIEWED,  the  calling  function  continues 
processing. 

The  usage  is  WAIT_MPVREPLY(). 


Defined  In: 


bootmpv.c 
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Called  By:  mpvideo_boot 

Routines  Called:  nix2_peek 

Parameters:  none 


B.66  XCLOSE 

The  XCLOSE  macro  calls  the  standard  close  routine  to  close  files.  Previously,  this  macro 
was  used  to  call  fclose  for  a  special  platform.  The  macro  has  been  retained  for  backward 
compatibility. 


Defined  In:  definitions.h 


Called  By: 


close_db 

get_lm 

oi)en_dbase 

open_ded 


Routines  Called:  close 


Parameters:  none 


B.67  XLSEEK 

The  XLSEEK  macro  calls  the  standard  Iseek  routine  to  move  to  the  beginning  of  a  file. 
Previously,  this  macro  was  used  to  call  flseek  for  a  special  platform.  The  macro  has  been 
retained  for  backward  compatibility. 


Defined  In:  definitions.h 


Called  By:  ded_load_dtp_code 

download_bvols 
get_lm 
getlmdp 
getside 
load_dbase 
open_dbase 
open_ded 


Routines  Called:  Iseek 
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Parameters:  none 


B.68  XOPEN 

The  XOPEN  macro  calls  the  standard  open  routine  to  open  files.  Previously,  this  macro 
was  used  to  call  fopen  for  a  special  platform.  The  macro  has  been  retained  for  backward 
compatibility. 


Defined  In: 
Called  By: 


deflnitions.h 


get_lm 

open_dbase 

open_ded 


Routines  Called:  open 


Parameters:  none 


B.69  XREAD 

The  XREAD  macro  calls  the  standard  read  routine  to  read  files.  Previously,  this  macro 
was  used  to  call  fread  for  a  special  platform.  The  macro  has  been  retained  for  backward 
compatibility. 


Defined  In:  deflnitions.h 


Called  By:  ded_load_dtp_code 

download_bvols 
get_lm 
getlmdp 
getside 
load_dbase 
open_dbase 
open_ded 


Routines  Called:  read 


Parameters:  none 


B.70  XWRITE 

The  XWRITE  macro,  defined  in  definitions  h,  is  no  longer  used. 
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APPENDIX  C.  OPERATING  SYSTEM  ROUTINES 

This  appendix  provides  brief  descriptions  of  the  various  operating  system  calls  and 
standard  C  library  routines  used  by  the  CIG  Real-Time  software. 

C.l  Special  OS  Service  Libraries 

The  following  table  describes  the  system-level  service  routines  used  by  the  CIG  Real-Time 
software. 


Routine 

Description 

Called  By 

iead_watchO 

Gets  the  cumulative  number  of 
SOO  uS  ticks.  Returns  the 
number  as  watchjcount. 

_move_load_module_stp_to_quad_buffer, 
_set_up_for_next_firame,  cigsimio_write, 
exchange_enet_data_sim,  local_terrain, 
msg_cig_ctl,  msg_end, 
msg_laser_request_range,  msg_pass_on, 
process_a_msg 

start_watchO 

Determines  which  type  of  CPU 
board  it  is  executing  on,  sets  up 
the  timer  registers  appropriately, 
clears  the  stopwatch  storage  areas, 
starts  the  timer,  and  enables  the 
interrupts.  Returns  hoord. 

_pend_on_frame_interrupt,  cig_config, 
db_mcc_setup,  exchange_enet_data_sim, 
file_control,  get_msg_2d,  hw_test,  upstart 

stop_watchO 

Gets  the  cumulative  number  of 
500  (100)uS  ticks,  stops  the 
timer,  and  turns  the  timer 
interrupts  off.  Returns 
watchcount. 

_pend_on_frame_interrupt,  simulation 

sysrup_offO 

Ignores  system/frame  interrupts 
by  moving  the  address  of  a  null 
interrupt  service  routine  into  the 
68010  exception  vector  space. 

_pend_on_frame_interrupt,  dti7_emu, 
gos_model,  gos_sysiem,  main  (rtl.c), 
n’Sg_cig_ctl,  s_step,  sys_control_init 

sysrup_on(maiIbox_ptr, 

message) 

Enables  system/firame  interrupts 
^'v  moving  the  address  of  the 
interrupt  service  routine  in  to  the 
68010  exception  vector  space. 
Wakes  up  a  pending  routine  by 
moving  the  calling  task's 
mailbox  address  and  the  message 
to  be  returned  to  locations  known 
to  the  isr. 

dtp_emu,  gos_model,  gos_single_step, 
gos_system,  host_if_debug, 
init_simulation,  s_step 
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C.2  Task  Management  (sc_*)  Routines 

The  following  table  describes  the  routines  that  handle  intertask  mailbox  communication  and 
the  creation  and  deletion  of  tasks  and  queues.  These  routines  are  standard  Ready  Systems’ 
VRTX  C  interface  libraries. 


Routine 

Description 

Called  By 

sc_accept 

Qears  messages  from  the 
specified  mailbox. 

host_if_debug,  init_simulation,  msg_end, 
simulation 

sc_delay 

Pauses  for  a  specifred  delay. 

_rowcol_rd,  bal_buffer_setup,  bootforce, 
config_ballistics,  exchange_enet_data, 
flea_host_if,  flea_io_task,  mpvideo_boot, 
mpvideojoad,  mpvideo_sim_init, 
slave_cig_enet_sync 

sc_fcreaie 

Creates  a  flag  group. 

main  (itLc) 

sc_fdelete 

Deletes  a  flag  group. 

main  (rttc) 

sc_finquiry 

Inquires  on  a  flag  group 

main  (rtLc) 

sc_Q)end 

Pends  on  a  flag  group. 

main  (rtLc) 

sc_fi»st 

Posts  to  a  flag  group. 

poll_shutdown 

scjock 

Locks  a  queue  to  prevent 
concurrent  use. 

mx2_open,  mx2 _peek,  mx2_push, 
mx2_skip,  mx3_open,  mx3_peek, 
mx3_push,  mx3_^p,  mx_open, 
mxjpeek,  mx_push  ,mx_skip 

sc_pend 

Waits  fw  a  message  to  be  posted 
to  the  specified  mailbox. 

flea_init_cig_sw,  init.simulation 

sc_post 

Posts  a  message  to  the  specified 
mailbox. 

_database_disable, 
_handle_request_local_terrain, 
cigsimio_fT^e_end,  conrig_ballisucs, 
exchange_flea_data,  flea,  nea_host_if, 
flea_init_cig_sw,  init_simulalion 

sc_screate 

Creates  a  semaphore. 

main  (rtLc) 

sc_sdelete 

Deletes  a  semaphore. 

main  (rtt.c) 

sc_sinquiry 

Inquires  on  a  semaphore's  status. 

poll_shutdown 

sc_spend 

Pends  on  a  semaphore 

main  (rtLc) 

sc_spost 

Posts  to  a  semaphore. 

rtt_shutdown 

sc_tinquiry 

Inquires  on  a  task. 

flea_io_task,  main  (bxl47_main.c),  main 
(rtt.c),  poll_shutdown 

sc_tresuine 

Resumes  a  suspended  task. 

flea,  main  (nt.c) 

sc_tsuspend 

Suspends  a  task. 

flea_io_task,  main  (bxl47_main.c) 

sc_unlock 

Unlocks  a  locked  queue. 

mx2_open,  mx2_peek,  mx2_push, 
mx2_skip,  mx3_open,  mx3_peek, 
mx3_push,  mx3_^ip,  mx_open, 
mx_peek,  mx_push,  mx_skip 
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C.3  IFX  File  Management  (ifx_*)  Routines 

The  following  table  identifies  the  Ready  Systems'  IFX  routines  used  by  the  CIG  Real-Time 
Software  to  manage  files  and  devices. 


Routine 

Description 

Called  By 

ifx_close 

Closes  a  file  or  device. 

CloseDir,  cigsimio_write,  esifa_load, 
flea_abs_playback,  gos_cigsiinio, 
sio_close,  tick_script 

ifx_ioctl 

Sets  i/o  control. 

esifa.download,  esifa_laser_retum, 
esifajoad,  esifa_read,  esifa_read_ports. 
esifa_send_req,  esifa_setup,  esifa_write, 
esifa_write_poits,  open_enet_interface 

ifx_open 

Opens  a  file  or  device. 

OpenDir,  cigsimio_write,  esifajoad, 
esifa_setup,  flea_abs_playback, 
gos_cigsimio,  open_enetJnterface, 
sio_init,  stdopen,  tick_Swnpt 

ifx_read 

Reads  fiom  a  file  or  device. 

ReadDir,  esifajoad,  exchange_drl  l_data, 
exchange_drll_data_sim,  get_next_packet 

ifx_sposn 

Rewinds  a  file. 

flea_abs_playback 

ibi_tdelete 

Deletes  a  task. 

poll_shutdown 

ifx_  rite 

Writes  to  a  file  or  device. 

cigsimio_write,  exchange_drl  l_data, 
exchange_drl  l_data_sim,  sio_tick 
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C.4  GTOS  Routines 

The  following  routines,  which  are  called  by  various  functions  in  the  real-time  software,  are 
part  of  the  GT  operating  system. 


Routine 

Description 

Called  By  | 

cif_connect 

Connects  to  an  interface. 

(^n_mpv_interface 

cif_init 

Initializes  the  communications 
driver. 

open_mpv_interface 

cif_receive 

Receives  a  buffer. 

exchange_mpv_data, 

exchange_mpv_data_sim 

cif_send 

Sends  a  buffer. 

exchange_mpv_data, 

exchange_mpv_data_sim 

c^)arse 

Parses  the  command  line  entered 
by  the  user. 

initialize 

inpv_ncatalog 

Catalogs  a  name. 

disable_restart 

mpv_nfind 

Finds  a  name. 

bal_buffer_setup,  check_restart 

panic 

Outputs  an  error  message. 

msg_laser_retum,  staticveh_remove 

pcieaie 

Creates  a  new  task. 

agptjnit,  config_ballistics,  main  (rttc) 

penor 

Prints  an  error  to  a  file. 

open_socket_interface 

print_allocp 

Prints  a  free  list. 

tst_tree 

saccqjt 

Accepts  from  a  socket. 

open_socket_interface 

sbind 

Binds  a  name  to  a  socket 

open_socket_interface 

search 

Searches  for  an  occurrence  of  a 
string  within  a  string. 

FindField,  esifajoad 

seiror 

Outputs  IFX,  VRTX,  and  MPV 
enors. 

agptjnit,  config_ballistics,  main 
(bxl47_main.c),  main  (ru.c), 
poIl_shutdown,  ru_shutdown 

sgbuffer 

Gets  a  buffer  from  the  socket 

exchange_socket_data, 

exchange_socket_data_sim, 

q)en_socket_interface 

sibuffer 

Initializes  a  socket  buffer. 

(q)en_socket_interfacc 

slisten 

Listens  to  a  socket 

(^n_socket_inter£ace 

spbuffer 

Puts  a  socket  buffer. 

exchange_socket_data, 

exchange_socket_data_sim 

srecv 

Receives  data  from  a  socket 

exchange_socket_data, 

exchange_sockel_data_sim 

ssend 

Sends  data  to  a  socket 

exchange_socket_data, 

exchange_socket_data_sim 

ssocket 

Opens  a  socket. 

open_socket_interface 
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C.5  Standard  C  Runtime  Libraries 

The  following  table  identifies  the  standard  C  system  calls,  inpul/output  routines,  and 
runtime  libraries  used  by  the  CIG  Real-Time  software. 


1  Routine 

Description 

Called  By 

acos 

Computes  an  arc  cosine. 

find_pitch_and_roll 

atan 

Computes  an  arc  tangent 

vptjjath_update 

atoi 

Converts  a  string  to  int 

host_if_disable_debug_msgs, 

host_if_enable_debug_msgs 

bcopy 

Copies  a  specified  number  of 
bytes  from  one  location  to 
another. 

backend_set_branch,  BCOPY,  cal , 
cig_config,  cigsimio_write, 
c(Mifig_translatOT,  esifa_queue_data, 
exchange_ene»_daia, 
exchange_enet_daia_sim, 
flea_abs_playback,  flea_bal_opts, 
flea_inii_cig_sw,  msg_calibration_image, 
open_enet_interf^,  process_*  (Flea 
cf_translator  functions),  sio_wriie, 
slave_cig_enet_sync,  ui>d_add_static_veh, 
upd_flea_vehicles,  iq)d_rem_static_veh, 
upd_send_dynamic,  upd_sio_wriie, 
i^_subsys_mode,  upd_view_mag, 
upd_viewpc»rt_up 

bzero 

Zeroes  out  a  buffer. 

config_tianslator,  process.*  (Flea 
cf.translator  functions) 

calloc 

Allocates  memory  and  initializes 
to  zero. 

autopilot,  cig_2d_setup,  dynamic.demo, 
find.fn,  flea,  siojnit,  vpt.cnode  _get, 
vpt_cnode_set_mauix,  vpij)ath.get 
vpt_vpt.get 

close 

Closes  a  file. 

close.db,  compile_2d,  file.control, 
find.fn,  flea,  get.lm,  gos.model , 
mpvideojoad,  t^n.dbase,  open.ded, 
sl^ 

cmd 

Sends  a  command  to  sio. 

getch 

cos 

Calculates  a  cosine. 

autopilot,  concat.mtx,  dynamic.demo, 
llea_init_cig_sw,  flea.sim  ulate.vehicles, 
flea.updatejxjs,  gos.model,  rotate.x, 
iotate_y,  rotate.z,  send_jun_overlay, 
tst.eupdate,  upd_rotation_values, 
vpi_path_updatc 

cieat 

Creates  a  file. 

main  (u_main2d.c) 

aeate_sz 

Creates  a  file  with  a  specified 
size. 

file.control 
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exit 

Deletes  the  current  task. 

config_ballistics,  config_color_td)le, 
config_database,  config_translator, 
exchange_enet_data,  flea,  flea_host_if , 
nea_init_cig_sw,  gossip,  init_simulation, 
initialize,  main  (bxl47_main.c),  main 
(ntc),  mpvideo_load,  open_dbase, 

(^n_drl  l_inter£ace,  open_enet_interface, 
q)en_scsi_interface, 
open_socket_inteiface, 
slave_cig_enet_sync,  sys_control_init, 
tst_ereadconfig 

fdose 

Closes  an  I/O  stream. 

compile_2d,  config_ballistics, 
config_color_table,  conrig_database, 
config_translator,  db_mcc_setup, 
flea_draw_2d,  initialize,  loadjcsifa, 
tst_ereadconfig 

fflush 

Writes  all  cunently  buffered 
characters  in  an  output  stream. 

host_if_debug_tick 

fgetc 

Reads  next  character  from  stream. 

p_configtiee_node,  process_2d_setup, 
process_configtree_node,  read_a_keyword, 
remove_comment_lines, 
remove_white_space 

fgets 

Reads  next  line  from  stream. 

config_balIistics,  config_color_table, 

config_database,  flea,  flea_draw_2d, 

get_msg_2d,  load_esifa, 

process_agl_setup,  process_cig_ctl, 

process_configtree_node, 

ITOcess_define_tx_mode, 

IMncess_file_description, 

process_overlay_setup, 

process_if_init_hdr,  process_tf_init_pt, 

process_viewport_state, 

/emove_comment_lines 

fopen 

Opens  an  I/O  stream. 

config_ballistics,  conng_color_table, 
conrig_database,  ccxifig_translator, 
db_mcc_setup,  flea,  flea_draw_2d, 
initialize,  load_esifa,  main,  tst.ereadconfig 

fprintf 

Writes  using  format  to  specified 
stream. 

flea,  flea_printf,  print_msg_* 

fputc 

Writes  character  to  stream. 

print_msg_sio_wrile,  slave_cig_enet_sync 

fiead 

Reads  specified  number  of 
characters  from  stream. 

next_char 

fiee 

Frees  allocated  memory. 

autopilot,  bO_add_traj_table, 
backend_sctup,  bx_reset ,  cig_2d_setup, 
close_db,  ded_uninit,  download_bvols, 
dtp_compiler,  dynamic_demo,  esifa_setup, 
find_fn,  flea,  flea_init_cig_sw, 
mem_check,  msg_calibration_image, 
open_dbase,  open_ded,  sio_close,  siojnit, 
vpt_tiee_free 
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fscanf 

Reads  from  stream  using  format 

p_configtree_node,  p_overlay_setup, 
p_terrain_feedback,  p_viewport_state, 
process_*  (Flea  cf_transIator  functions), 
read_a_keyw(Hd,  setup_p_terrain_feedback, 
tst^ereadconfig 

getenv 

Get  string  value  associated  with 
oivironmcnt  variable 

pretend_veh 

gets 

Gets  a  string. 

get_sio_write_data,  gos_mpvio 

isalpha 

Tests  character  to  see  if  letter. 

get_thing 

isdigit 

Tests  character  to  see  if  digit. 

flea_di:aw_2d,  get_thing 

isprint 

Tests  character  to  see  if  printable. 

flca_agpt_locations,  flea_agpt_switches, 
flea_atp,  flea_bal_opts,  flea _gr^hics_test, 
flea_switches,  flea_veh_control, 
gossip_tick,  tick,  tick_ppm,  tick_script 

isspace 

Tests  character  to  see  if  space, 
tab,  carriage  return,  newline, 
vertical  tab,  or  formfeed. 

flea_agpt_locations,  flea_agpt_switches, 
flea_aq),  flea_bal_opts,  flea_draw_2d, 
flea _gr^hics_test,  flea_switches, 
flea_veh_control,  gossip_tick,  tick, 
tick_ppm,  tick_script 

Iseek 

Moves  the  read/write  pointer. 

ded_load_d4)_code,  download_bvols, 
file_control,  get_lm,  getlmdp,  getside, 
gos_model,  load_dbase,  open_dbase, 
open_ded 

malloc 

Allocates  memory. 

bO_add_traj_table,  bO_database_info, 
backend.setup,  ded_setup, 
download_bvols,  d5)_compiler, 
esifa_setup,  flea,  flea_init_cig_sw, 
host_if_debug_init ,  mem_check, 
mpvideo_setup,  msg_calibration_image, 
(^n_dbase,  open_ded,  sio_init 

max 

Determines  the  largest  of  a  sa  of 
values. 

exchange_enet_data, 

exchange_enet_data_sim, 

slave_cig_enet_sync 

min. 

Determines  the  smallest  of  a  set 
of  values. 

iiipvideo_pass_on 

open 

Opens  a  file. 

file_control,  fmd_fn,  flea,  get_lm, 
gos_model,  gossip,  mpvideo_load, 
(^)en_dbasc,  (^n_ded, 
open_drl  l_interface,  open_scsi_interface, 
sload 

outhexl 

Outputs  hex  data. 

bO_dclete_stalic_vehicle,  bO_state_control, 
bO_traj_chord,  bO_traj_entry,  bx_task 

printf 

Writes  to  stdout. 

(used  extensively  throughout  system) 

puts 

Writes  to  stdout 

bO_bvol_entry,  bO_delete_static_vehicle, 
bOJnapp_message,  bO_print, 
bO_state_control,  bO_traj_chord, 
bO_traj_entry,  bO_undefined_message, 
bx_task 
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read 

Reads  a  file. 

ded_load_dtp_code,  download_bvols, 
exchange_scsi_data, 
exchange_scsi_daia_sim.  file_control, 
get_char,  get_lm,  getlmdp,  getside, 
gos_model,  load.dbase,  mpvideojoad, 
c^)en_dbase,  open_ded 

read_tly 

Reads  operator  input 

flea,  flea_getchar,  gos_getchar 

rewind 

Repositions  stream  pointer  to 
beginning  of  file. 

flea 

isec 

Reads  multiple  sectors  from  disk. 

file.control 

scanf 

Reads  from  stdin. 

dtp_emu.  flea,  flea_bal_opts, 
flea_draw_2d,  flea_swiiches, 
flea_veh_control,  gos_120u, 
gos_bal_query,  gos_cigsimio, 
gos_db_query,  gosjocate,  gos_memory, 
gos_model,  gos_mpv,  gos_mpvio, 
gos _ppm_query,  gos_system,  gossip_tick, 
host_if_disable_debug_msgs, 
host_if_enable_debug_msgs,  main, 
model_demo,  tick,  tick_ppm,  tick_script, 
tst_edebug,  tst_equery,  tst_ereadconfig, 
tst_eupdate,  tst_tree,  tst_treetrace, 
vptq_brvals,  vptq  cnout  vptq_dynmtx, 
vptg  grout  vptq_vpout,  vptq_vptbrout 

sin 

Calculates  a  sine. 

autopilot  concat_mtx,  dynamic_demo, 
flea_init_cig_sw,  flea_simulate_vehicles, 
flea_update_pos,  gos_model,  rotate_x, 
rotatc_y,  rotate_z,  send_gun_overlay, 
tst_eupdate,  upd_rotation_valui.  s, 
vpt_p^_update 

sprintf 

Places  formatted  string  in 
character  anay. 

config_database,  open_scsi_interface 

sqn 

Calculates  a  square  root. 

dtp_emu,  find_pitch_and_roll,  gos_model 

sscanf 

Scans  input  from  stdin. 

conng_ballistics,  conrig_color_table, 
config^database,  flea,  flea_draw_2d, 
get_sio_write_data,  init_enet_inierface, 
load_esifa,  mpvideojoad 

strcat 

Concatenates  two  strings. 

find_fh,  get_sio_write_data 

strcmp 

Compares  two  strings. 

config_ballistics,  config_translator, 
db_mcc_setup,  findjn,  flea,  flea_draw_2d, 
flea_printf,  msg_shell_sort ,  nexl_token, 
p_configtree_node,  p_overlay_setup, 
p_terrain_feedbaclt  p_viewpott_state, 
process_*  (Flea  cf_translator  functions), 
sctup_comp_stail,  tst_creadconfig 
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conhg_database,  config_translator, 
db_mcc_setup,  file_control,  find_fn,  flea, 
flea_agpt_locations, 
flea_agpUocaiions_main_menu, 
flea_agpl_switches, 

flea_agpt_swiu:hes_main_menu,  flea_atp, 
flea_atp_inain_menu,  flea_bal_opts, 
flea_bal_opts_main_inenu, 
flea_graphics_lest , 
flea_gR^hics_test_main_menu, 
flea_mit_cig_sw,  flea_prompt , 
Qea_switches,  flea_switches_inain_menu, 
flea_veh_control, 
flea_veh_conooLinain_inenu, 
gos_(Ib_query_menu,  gos_prompt, 
host_if_disable_debug_msgs, 
host_if_enable_debug_msgs, 
init_subsys_parser ,  initialize,  main, 
parse_subsys_file,  set_3d_lui_name, 
set_colOT_config_name,  set_data_2d_name, 
set_database_name,  sel_ded_name, 
set_esifa_name,  set_fjnaljut_name, 
tick_script,  tick_script_main_menu, 
vpl_cnode_process 


strlen 

Returns  string  length. 

config_database,  db_mcc_setup, 
file_control,  find_fn,  flea_init_cig_sw, 
get_sio_write_data,  gos_cigsimio,  gossip, 
initialize,  open_dbase,  open_ded, 
setup_define_string,  setup_text 

stmcmp 

Compares  first  n  characters  of 
two  strings. 

db_mcc_setup,  fmd_fn,  mpvideojoad 

stmcpy 

Copies  first  n  characters  of  string. 

find_fh 

stnrchr 

Searches  string  for  last  occurrence 
of  character. 

esifajoad 

strto! 

Converts  an  ASCII  string  to  a 
long. 

esifajoad,  mpvideojoad 

system 

Executes  a  shell  command. 

file_control 

tan 

Calculates  a  tangent 

vpt_path_process,  vpt_path_update, 
vpt_update 

toupper 

Converts  a  character  to  uRiCTcase. 

find_fh 

unbf_getchar 

Performs  an  unbuffered  getchar. 

cal,  dq)_emu,  gos_120u,  gos_bal_query, 
gos.cigsimio,  gos_db_query, 
gos_memory,  gos_model,  gos_mpv, 
gos_mpvio,  gos_ppm_query,  gos_system, 
gossip,  host_if_debug_menu, 
hostJf_display_enabled_msgs,  s_step 

ungetc 

Performs  an  unbuffered  getchar. 

icad_a_keywoid,  remove_comment_lines, 
remove_white_space 

write 

Writes  a  specified  number  of 
bytes. 

exchange_scsi_data, 
exchange_scsi_data_sim,  file_cond‘ol, 
gos_model,  linkup 

807 


GTIOO  RTSW  CSCI 


BBN  Systems  and  Technologies 

APPENDIX  D.  GLOSSARY  OF  TERMS  AND  ABBREVIATIONS 


2-D 

AAM 

AGL 

ASID 

aspect  ratio 
backend 

bvol 

centroid 


channel 

.CIG 

clipping 

conditional  node 
configuration  tree 


Two-dimensional. 

Active  area  memory.  Memory  that  contains  the  currently  viewable 
database  and  models.  AAM  contains  256  terrain  load  modules  (16 
rows  by  16  columns).  This  provides  a  3500-meter  viewing  range, 
plus  a  5(X)-meter  buffer,  in  each  direction.  If  load  module  bloclang 
is  enabled,  AAM  is  effectively  quadrupled. 

Above  ground  level.  If  AGL  processing  is  enabled  (via  the 
MSG_AGL_SETUP  message),  the  simulated  vehicle's  altitude 
above  ground  level  is  calculated  and  returned  to  the  Simulation  Host 
every  frame. 

Application-specific  identification  data.  ASIDs  are  used  to  add 
unique  data  (bumper  numbers,  smoke  plume,  dust  cloud,  etc.)  to  a 
model. 

The  ratio  of  the  sides  (width  :height)  of  the  viewport. 

A  9U  Channel  Subassembly  in  the  CIG.  The  backend  contains 
special-purpose  graphics  boards  that  transform  terrain,  model,  and 
special  effects  data  to  viewpoint  space.  One  CIG  can  contain  two 
backends. 

Bounding  volume.  The  volume  of  the  bounding  box  that  is  used  to 
completely  enclose  an  object  in  the  simulation  environment. 

The  theoretical  "center"  of  an  object,  around  which  the  object  is 
rotated.  The  centroid's  coordinates  are  the  averages  of  the 
corresponding  coordinates  of  a  given  set  and,  for  a  given  planar  or 
three-dmensional  figure  (such  as  a  triangle  or  sphere),  correspond 
to  the  center  of  mass  of  a  thin  plate  of  uniform  thickness  and 
consistency  or  a  body  of  uniform  consistency  having  the  same 
boundary. 

A  connection  to  a  viewport.  One  channel  may  have  multiple 
graphics  paths. 

Computer  Image  Generation  System.  The  process  of  generating  a 
3-D,  perspectively  accurate  scene  via  a  computer. 

Remov  ing  back-facing  polygons  or  pans  of  polygons  that  lie 
partially  outside  the  viewing  pyramid. 

A  node  in  the  configuration  tree  that  causes  a  branch  into  one  of  two 
traversal  paths  bas^  on  some  runtime  condition. 

A  structure  that  defines  the  relationship  between  each  physical 
component  of  the  simulation  vehicle  and  the  location  of  the 
viewports. 
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data  message 

data  message  header 

DED 

double-buffer 

memory 

downloading 

DRll-W 

DTP 

ESIFA 

EVC 

dynamic  vehicle 
false  child 

fov 

frame 

frame  event 
frame  rate 

frame  time 


Smallest  data  component  of  a  packet  buffer. 

A  message  that  describes  the  contents  of  a  data  message. 
Dynamic  Elements  Database. 


Memory  that  contains  the  dynamic  models  built  by  the  real-time 
software  and  processed  by  the  hardware.  Dual  buffering  allows  for 
one  buffer  to  be  used  by  the  hardware  while  the  other  is  being 
updated  by  the  software.  The  buffer  used  for  each  purpose  switches 
each  frrame,  so  the  hardware  is  always  using  the  buffer  updated  by 
the  software  during  the  previous  frame. 

The  process  of  transferring  data  from  the  Simulation  Host  to  the 
CIG. 

A  Digital  Equipment  Corp.  standard  interface  that  enables  the 
Simulation  Host  and  the  CIG  processor  to  communicate  at  a  high 
transmission  rate. 

Data  Traversal  Processor. 

Enhanced  Subsystem  Interface  Adapter.  The  subsystem  card  that 
provides  a  communications  path  between  the  real-time  software  and 
the  other  boards  in  the  9U,  including  the  Pixel  Processor  Memory 
(PPM)  and  the  Pixel  Processor  Tiler  (PPT). 

Ethernet  VME  Controller.  The  board  in  the  CIG  that  allows  frame 
interrupts  onto  the  VME  bus. 

A  vehicle  whose  position  and  orientation  is  redefined  in  every  frame 
sent  by  the  Simulation  Host. 

The  configuration  tree  node  branched  to  from  a  conditional  node  if 
the  runtime  conditions  is  false. 

Field  of  view.  The  volume  of  space  which  encompasses  all  objects 
that  are  visible  from  a  specific  viewpoint  and  view  angle. 

Information  displayed  on  a  video  monitor  for  a  duration  determined 
by  the  frame  speed  (e.g.,  33.3  milliseconds  at  30  Hz  or  66.6 
rnilliseconds  at  15  Hz). 

An  interrupt  signal  given  by  the  hardware. 

The  rate  at  which  a  new  image  is  created  and  displayed  on  the 
screen. 

The  amount  of  time  each  frame  is  displayed. 
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graphics  path 

GSP 

graphics  processor 

heading 

hull  transformation 
Hz 

load  module 

load  module  block 

lod 

lookup  table 
lut 

matrix 
matrix  node 

MCC 

model 

model  space 


A  window  on  a  viewport.  A  T  backend  has  one  graphics  path  per 
viewport  A  TX  backend  may  have  two  or  four  graphics  paths, 
depending  on  viewport  resolution.  Graphics  path  parameters  are  the 
viewport  parameters  that  are  used  to  load  the  hardware. 

Graphics  System  Processor.  The  TMS34010  graphics  processor  on 
the  MPV  board  that  generates  and  controls  2-D  graphics. 

First  board  in  the  graphics  pipeline  that  processes  3-D  data  and 
converts  it  into  2-D  screen  space  for  the  tiler,  based  on  the  input  of 
graphics  processor  commands.  Also  called  the  Poly  Processor. 

The  direction  the  viewer  is  pointing. 

Description  of  the  position  and  orientation  of  the  base  of  a  vehicle. 
Hertz;  cycles  per  second. 

A  unit  of  terrain  in  the  terrain  database,  measuring  500  meters  by 
500  meters.  Data  is  brought  into  active  area  memory  in  whole  load 
modules  only. 

A  stmcture  containing  four  load  modules  (two  rows  by  two 
columns,  for  a  total  size  of  1(XX)  meters  by  1(XX)  meters).  Blocking 
load  modules  doubles  the  viewing  range  and  quadruples  the  amount 
of  terrain  that  can  be  loaded  into  active  area  memory. 

Level  of  detail.  The  selective  reduction  of  model  detail  (polygon 
count)  or  texture  map  detail  based  on  distance  from  the  viewer. 

A  table  used  to  convert  color-map  addresses  into  the  actual  color 
values  displayed. 

Lookup  table. 

A  rectangular  array  of  elements  arranged  in  rows  and  columns. 

A  node  in  the  configuration  tree  that  contains  a  transformation 
matrix.  The  matrices  in  each  node  in  a  traversal  path  are 
concatenated  to  generate  the  view  of  the  world  for  the  viewport 
represented  by  that  path. 

Management,  Command,  and  Control.  The  computer  on  the 
simulation  network  that  monitors  and  controls  the  entire  simulation 
exercise. 

Generally  used  to  refer  to  models  of  arbitrary,  three-dimensional 
objects  such  as  buildings  and  vehicles. 

The  coordinate  system  used  to  define  and  build  a  particular  model. 
The  vehicle's  centroid  is  defined  as  location  (0,0,0). 
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• 

MPV 

Micro  Processor  Video.  The  last  board  in  the  graphics  pipeline  in  a 

TX  backend. 

My_Vehicle 

The  simulation  vehicle. 

object 

All  simulated  models:  vehicles,  hidden  obstacles,  etc. 

overlay 

A  two-dimensional  view  that  is  displayed  on  a  viewport  on  top  of 
the  three-dimensional  view  of  the  terrain. 

packet  buffer 

Several  data  messages  grouped  together  that  describe  one  frame 
time. 

pitch 

The  angle  at  which  the  viewer  is  looking  up  or  down. 

pixel 

Picture  element.  The  smallest  addressable  element  on  a  video 
screen. 

point  lights 

Light  sources  that  can  be  defined  from  a  specific  location  in  xyz 
world  space.  This  differs  from  directional  lighting  which  is  defined 
from  a  certain  direction  and  originates  at  infinity. 

Poly  Processor 

See  graphics  processor. 

• 

polygon 

A  closed,  planar  figure  bounded  by  straight  lines  and  consisting  of 
three  or  four  vertices. 

PPM 

Pixel  Processor  Memory.  A  board  in  a  T  backend  that  assembles 
individual  pixels  from  the  PPT  into  a  display  matrix  that  is  the  final 
spatial  representation  of  an  image. 

PPT 

Pixel  Processor  Tiler.  An  integer  processor  board  that  tiles  three- 
and  four-sided  polygons  with  face  shading  or  texturing  pixels. 

real-time 

The  ability  to  respond  rapidly,  frequently,  or  both  to  an  event  or 
transaction.  Also  refers  to  the  software  that  is  used  to  run  real-time 
operations. 

roll 

The  angle  which  measures  the  amount  of  rotation  along  the  viewing 
vector  (tilt). 

rotation 

The  process  by  which  coordinates  are  rotated  around  a  particular 
axis.  Used  to  define  the  direction  of  the  viewing  window. 

rotation  matrix 

A  means  of  specifying  orientation. 

RCL 

Runtime  command  library  .  A  set  of  routines  used  to  generate 
hardware  commands  for  the  DTP  and  the  Poly  Processor. 

• 

RTS 

Rotation  translation  scale. 
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scaling 

SIM 

simulation 

simulation  vehicle 
simulator 

static  vehicle 

subsystem 

T&C 

terrain  database 

translation 

transformation 

transformation  matrix 
true  child 

vector 

vertex 

viewpoint 

viewport 


The  process  by  which  an  object’s  coordinates  are  changed  to 
effectively  enlarge,  reduce,  or  skew  the  object  in  a  particular 
direction. 

The  Simulation  Host  computer.  The  computer  that  controls  the 
simulated  vehicle’s  behavior. 

The  process  that  involves  a  computerized  model  of  specific, 
significant  features  of  some  physical  or  logical  system  or 
environment. 

The  vehicle  represented  by  a  simulated  viewpoint.  Also  called 
simulated  vehicle  ot  My_Vehicle. 

A  simulation  unit  consisting  of  a  Simulation  Host,  a  CIG,  one  or 
more  monitors,  and  the  vehicle  controls.  Also  called  a  Vehicle 
Simulator  Unit. 

A  vehicle  with  no  anticipated  movement,  tracked  only  when  its 
status  changes. 

See  backend. 

Timing  and  Control.  Board  that  controls  all  CIG  synchronization 
and  timing. 

The  database  on  the  CIG  that  contains  the  polygons  that  describe  the 
simulation  terrain  and  all  objects  (houses,  trees,  etc.)  in  it. 

The  process  by  which  coordinates  are  "moved"  from  one  location  to 
another. 

A  combination  of  translations  and  rotations  that  convert  the 
coordinates  of  a  point  in  one  coordinate  system  into  coordinates  in 
another  coordinate  system. 

A  matrix  used  to  describe  the  position  and  orientation  of  an  object. 

The  configuration  tree  node  branched  to  from  a  conditional  node  if 
the  mntime  conditions  is  true. 

A  straight  line  with  a  specific  direction. 

A  point  in  space,  the  termination  point  of  a  line,  or  the  intersection 
point  of  two  or  more  lines. 

The  direction  of  view  from  the  user’s  eye  to  the  target  or  object 
being  viewed. 

A  display  screen  connected  to  the  CIG.  Each  viewport  simulates  the 
view  of  the  world  from  a  specific  window  of  the  simulated  vehicle. 
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viewport  parameters 

viewspace 

VME 

world  space 


The  screen  resolution,  viewing  range,  near  plane,  field-of-view 
angles,  level-of-detail  multiplier,  and  aspect  ratio  of  a  viewport. 

The  area  that  falls  within  the  field  of  view  of  a  viewport 

Versa  Module  European.  An  industry-standard  bus. 

The  absolute  coordinate  system  used  to  define  the  simulation  area. 
A  three-dimensional  space  fixed  relative  to  the  world.  Location 
(0,0)  is  the  southwest  comer  of  the  database. 
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APPENDIX  E.  CROSS-REFERENCE  TABLES 

This  appendix  contains  the  following  cross-reference  tables; 

E.  1  CSUs  (source  files)  mapped  to  CSCs. 

E.2  Data  type  names  mapped  to  typedef  locations. 

E.3  Function  names  mapped  to  source  file  locations,  with  section  numbers. 
E.4  Macro  names  mapp^  to  source  file  locations,  with  section  numbers. 
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E.l  CSUs  Mapped  To  CSCs 

The  following  list  shows  every  CSU  (x  or  .asm  file)  in  the  GT  Real-Time  Software  CSCI, 
and  identifies  the  CSC  to  which  it  belongs.  The  CSUs  are  listed  in  alphabetical  order. 


CSU 

aa_iiiit.c 

aam_manager.c 

agpt_init.c 

agpt_statistics.c 

autopilot.c 

bO_aam_ccntroid.c 

bO_aain_sw_comer.c 

bO_add_static_vehide.c 

bO_add_traj_table.c 

bO_bal_config.c 

bO_bvol_entry.c 

bO_cancel_round.c 

bO_cig_frame_rate.c 

bO_database_info.c 

bO_delete_static_vehicle.c 

bO_deletfi_traj_table.c 

bO_eiror_deiected.c 

bO_inapp_message.c 

bO_Im_read.c 

bO_inodel_diiectory.c 

bO_model_entry.c 

bO_new_frame.c 

bO_print.c 

bO_process_chord.c 

bO_|TOcess_round.c 

bO_n)und_fired.c 

bO_state_control.c 

bO_status_requesLc 

bO_tf_init_hdr.c 

b0_tfjnit_pt.c 

bO_tf_state.c 

bO_tf_vehiclejx)S.c 

bO_traj_chord.c 

bO_traj_entry.c 

bO_undefined_message.c 

backend_branch.c 


CSC 

Backend  Manager 
CIG  Configuration 
Real-Time  Processing 
User  Interface  Mode 
Stand- Alrme  Host  Emulator 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  Processing 
Ballistics  fYocessing 
Ballistics  Processing 
Ballistics  Processing 
Backend  Manager 
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csu 

CSC 

backend_colOT.c 

Backend  Manager 

backend_laser.c 

Backend  Manager 

backend_man.c 

Backend  Manager 

backend _paths.c 

Backend  Manager 

backend_thOTnal.c 

Backend  Manager 

backend_video.c 

Badcoid  Manager 

bal_get_db_pos.c 

Real-Time  Processing 

bal_get_lm _grid,c 

Real-Time  Processing 

bal_routines.c 

Real-Time  ftocessing 

ball_effect_add.c 

Real-Time  Processing 

bbnctype.c 

CIG  Configuration 

be_stubs.c 

Viewport  Configuration 

bit_blt.c 

2-D  Overlay  CompDer 

blcopy.c 

System  Utilities 

bootforce.c 

MPV  Interface 

bootmpv.c 

MPV  Interface 

buffer_enors.c 

User  Interface  Mode 

bxl47_main.c 

Task  Initialization 

bx_bvol_int.c 

Ballistics  Processing 

bx_chOTd_intersecLc 

Ballistics  Processing 

bx_conipute_roundc 

Ballistics  Processing 

bx_find_vehicle.c 

Ballistics  Processing 

bx_funciions.c 

Ballistics  Processing 

bx_gct_lni_data.c 

Ballistics  Processing 

bx_gel_lin  _grid.c 

Ballistics  Processing 

bx_init.c 

Ballistics  Processing 

bx_modeI_int.c 

Ballistics  Processing 

bx_poly_int.c 

Ballistics  Processing 

bx_probe.c 

Ballistics  Processing 

bx_reset.c 

Ballistics  Processing 

bx_task.c 

Ballistics  processing 

bx_tf_pack.c 

Ballistics  Processing 

bx_tiajectory.c 

Ballistics  Processing 

cai.c 

Real-Time  processing 

cf_tianslator.c 

Stand-Alone  PPost  Emulator 

cig_2d_setup.c 

2-D  Overlay  Compiler 

cig_comp_2d.c 

2-D  Overlay  Compiler 

cig_config.c 

CIG  Configuration 

cig_getm_2d.c 

2-D  Overlay  Compiler 

cig_link_2d.c 

2-D  Overlay  Compiler 

cigsiinio_obj.c 

Real-Time  Processing 

close_db.c 

Real-Time  Processing 

clouds.c 

Real-Time  Processing 
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csu 

CSC 

cnodejchilAc 

Viewport  Conflguration 

cno(fci_getc 

Viewport  Configuration 

cnodejHOcessx 

Viewpat  Configuration 

cnode_quay.c 

Viewport  Coniiguration 

cnode_seLc 

Viewport  Connguration 

compx 

2-D  Overlay  Compiler 

conng_ballisticsx 

Real-Time  Processing 

config_color_tablex 

Real-Time  Processing 

config_databasex 

Real-Time  Processing 

data_typex 

Force  Processing 

db_incc_setupx 

Real-Time  Processing 

debug_initdrx 

Real-Time  Processing 

ded_gm_poolx 

Real-Time  Processing 

ded_model_tracex 

Real-Time  Processing 

ded_objecLc 

User  Interface  Mode 

directoryx 

System  Utilities 

dl_manx 

Backend  Manager,  Real-Time  Processing 

download_bvolsx 

Real-Time  Processing 

draw_linex 

2-D  Overlay  Compiler 

dtp_compilerx 

DTP  Command  Generator 

dq)_emux 

User  Interface  Mode 

dlp_funcsx 

DTP  Command  Generator 

dqp.travlx 

DTP  Command  Generator 

dtp_trav2x 

DTP  Command  Generator 

dynamic_demox 

Stand-Altme  Host  Emulator 

effect_downcounLc 

Real-Time  Processing 

encode_routinesx 

Stand-Alone  Host  Emulator 

esifa_fadex 

ESBFA  Interface 

esifa_laserx 

ESIFA  Interface 

esifa_load.c 

ESIFA  Interface 

esifa_manx 

ESIFA  Interface 

esifa_queryx 

ESIFA  Interface 

esifa_specialx 

ESIFA  Interface 

esifa_thennalx 

ESIFA  Interface 

esifa_videox 

ESIFA  Interface 

exceplion.asin 

Force  Processing 

10_3dlut_downloadx 

Fort:e  Processing 

fD_3dlut_switchx 

Force  Processing 

fO_aIIlut_switchx 

Force  Processing 

fO_(fcbug_disablex 

Force  Processing 

fO_debug_enablex 

Force  Processing 

fO_final_lut_downloadx 

Force  Processing 

fD_final_lut_switchx 

Force  Processing 
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csu 

CSC 

fD_mode_selecLc 

Force  Processing 

fD_mpv_init.c 

Force  Processing 

fO_mpv_lut_type_request.c 

Force  Processing 

fO_mpv_peek.c 

Force  Processing 

fO_mpv_poke.c 

Force  Processing 

f0_mpv_pokel6.c 

Force  Processing 

fO_nipv_rcset.c 

F<Mce  Processing 

fO_mpv_task_control.c 

Force  Processing 

fD_mpv_tesLc 

Force  Processing 

fO_mpv_write.c 

Force  Processing 

fO_pass_on.c 

Force  Processing 

fO_pixel_depth_request.c 

Force  Processing 

fD_quCTy.c 

Force  Processing 

fO_set_display.c 

Force  Processing 

fO_trigger.c 

Force  Processing 

fO_unknown.c 

Force  Processing 

fl_force_iniLc 

Force  Processing 

fl_initjump_table.c 

Force  Processing 

fl_pixel_address.c 

Force  Processing 

fl_I»'ocess_messages.c 

Force  Processing 

f  1  _setup_environmentc 

Force  Processing 

file_control.c 

Real-Time  Processing 

fill_tree.c 

CIG  Configuration 

find_field.c 

System  Utilities 

find_gtfh.c 

System  Utilities 

flagoff.c 

Viewpwt  Configuration 

fleac 

Stand-Alone  Host  Emulator 

flea_agl_terrain_follow.c 

Stand-Alone  Host  Emulator 

flea_agpt_locations.c 

Stand-Alone  Host  Emulator 

flea_agpt_swiiches.c 

Stand-Alone  Host  Emulator 

flea_aQ).c 

Stand-Alone  Host  Emulator 

flea_bal_{5)ts.c 

Stand- AltHie  Host  Emulator 

flea_db_traverse '' 

Stand-Alone  Host  Emulator 

flea_decode_data.c 

Stand-Alone  Host  Emulator 

flea_demo.c 

Stand- AltHie  Host  Emulator 

flea_draw_2d.c 

Stand-Alone  Host  Emulator 

Qea_encode_datac 

Stand-Alone  Host  Emulator 

flea_gTaphics_test.c 

Stand-Alone  Host  Emulator 

flea_init_cig_sw.c 

Stand-Alone  Host  Emulator 

flea_ppm_obj.c 

Stand-Alone  Host  Emulator 

flea_script.c 

Stand-Alone  Host  Emulator 

flea_simulate_vehicles.c 

Stand-Alone  Host  Emulator 

flea_switches.c 

Stand-Alone  Host  Emulator 
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csu 

CSC 

• 

flea_update_pos.c 

Stand-Alone  Host  Emulator 

flea_veh_cc«itrol.c 

Stand-Alone  Host  Emulator 

forceasm 

Force  Processing 

forcetaskx 

Force  Processing 

fxbvtofl.c 

Real-Time  Processing 

generic_lm.c 

Real-Time  Processing 

get_sio_data.c 

Stand-Alone  Host  Emulator 

get_thing.c 

2-D  Overlay  Compiler 

get_txjut_index.c 

Real-Time  Processing 

get_vehicle_position.c 

CIG  Configuration 

getch.c 

CIG  Configuration 

global_initc 

Real-Time  Processing 

globs.c 

ViewpcHl  Configuration 

gos_120tx.c 

User  Interface  Mode 

gos_bal_query.c 

User  Interface  Mode 

gos_db_query.c 

User  Interface  Mode 

gosjocate.c 

User  Int^fkx  Mode 

gos_tnemoryx 

User  Interface  Mode 

gos_modelx 

User  Interface  Mode 

gos_mpvx 

User  Interface  Mode 

gos_mpviox 

User  Interface  Mode 

• 

gos_polysx 

User  Interface  Mode 

gos_systemx 

UsCT  Interface  Mode 

gossipx 

User  Interface  Mode 

gsp_iox 

Force  Processing 

giin_overlaysx 

Real-Time  Processing 

host_drll_ifx 

Host  Interface  Manager 

host_enet_ifx 

Host  Interface  Manager 

host_fleaJfx 

Host  Interfax  Manager 

host_if_debugx 

Host  Interface  Manager 

host_mpv_ifx 

Host  Interface  Manager 

host_scsi_ifx 

Host  Interface  Manager 

host_socket_ifx 

Host  Interface  Manager 

hw_tesuc 

Real-Time  Processing 

init_freex 

Viewport  Configuration 

init_simx 

Real-Time  Processing 

init_stuffx 

2-D  Overlay  Compiler 

lexx 

Token  Processing 

linkvptx 

Viewport  Configuration 

load_dbasex 

Real-Time  Processing 

load_esifax 

Real-Time  Processing 

• 

load_niodulesx 

Real-Time  Processing 

loadmpvx 

MPV  Interface 
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csu 

CSC 

loc_ter.c 

Real-Time  Processing 

loc_ter_msg.c 

Message  Processing 

make_bbn.c 

Real-Time  Processing 

make_bbn_logo.c 

User  Interface  Mode 

mkcal.c 

Task  Initialization 

inkmtx_nt.c 

Real-Time  Processing 

model_demo.c 

Stand- Alme  Host  Emulator 

model_mtx.c 

Real-Time  Processing 

mpvi(leo_laser.c 

MPV  Interfax 

mpvideojutx 

MPV  Interface 

mpvideo_man.c 

MPV  Interface 

inpvideo_inode.c 

MPV  Interface 

mpvideoj5ass_back.c 

MPV  Interface 

mpvideo_pass_on.c 

MPV  Interface 

mpvideo_prinLC 

MPV  Interface 

mpvideo_query.c 

MPV  Interface 

mpvideo_response.c 

MPV  Interface 

insg_calibration_image.c 

Message  Processing 

msg_cig_ctl.c 

Message  Processing 

msg_drll.c 

Message  Processing 

msg_effecLc 

Message  Processing 

msg_end.c 

Message  Processing 

msg  .laser.c 

Message  Processing 

msg_laser_retum.c 

Message  Processing 

nisg_lt_state.c 

Message  Processing 

msg_pass_back.c 

Message  Processing 

msg_pass_on.c 

Message  Processing 

msg_ppm.c 

Message  Processing 

msg_process_round48.c 

Message  Processing 

msg_subsys_mode.c 

Message  Processing 

msg_syserr.c 

Message  Processing 

msg_veh_staie.c 

Message  Processing 

ms&_vflags.c 

Message  Processing 

msg_vporLc 

Message  Processing 

mtx_concaLc 

Viewport  Configuration 

mtx_dump.c 

ViewpcHt  Configuration 

mtx_viewspace.c 

Viewport  Configuration 

mx2_hword.c 

Force  Processing,  Real-Time  Processing 

mx3_hword.c 

User  Interface  Mode 

mx_enDr.c 

Ballistics  Processing 

mx_open.c 

Ballistics  Processing 

mx_peek.c 

Ballistics  Processing 

mx_push.c 

Ballistics  Processing 
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csu 

CSC 

mx_skip.c 

Ballistics  Processing 

mx_wc(^y.c 

Ballistics  Processing 

nini_type.c 

Force  Processing 

open_dbase.c 

Real-Time  Processing 

open_ded.c 

Real-Time  Processing 

otherveh_state.c 

Real-Time  Processing 

oval_recLc 

2-D  Overlay  Compiler 

overlay_setup.c 

CIG  Connguration 

path.c 

Viewport  Configuration 

path_init.c 

Viewpwt  Configuration 

path_query.c 

Viewport  Configuration 

poU_ready.c 

Force  Processing 

poly.c 

2-D  Overlay  Compiler 

ppm_obj.c 

Backend  Manager 

pretend_veh.c 

Real-Time  Processing 

print_iiisg.c 

Message  Processing 

proc_cmd.c 

2-D  Overlay  Compiler 

process_vflags.c 

CIG  Configuration 

process_vppos.c 

CIG  Configuration 

icfuncsx 

DTP  Command  Generator 

replace_mod.c 

User  Interface  Mode 

rowcoLfdc 

Real-Time  Processing 

rt_mailbox.c 

Real-Time  Processing 

rtt.c 

Task  Initialization 

rttjnitx 

Real-Time  Processing 

shot_report.c 

Ballistics  Processing 

show_effect_msg.c 

Message  Processing 

simulalion.c 

Real-Time  Processing 

sio.c 

Serial  Device  Input/Output 

sloadx 

System  Utilities 

staticveh_rcmove.c 

Real-Time  Processing 

static  veh_state.c 

Real-Time  Processing 

stdopenx 

System  Utilities 

stringx 

2-D  Overlay  Compiler 

subsys_cfgj5arsex 

Token  Processing 

sys_controlx 

Real-Time  Processing 

test_coinmandsx 

User  Interface  Mode 

test_gspx 

Force  Processing 

textx 

2-D  Overlay  Compiler 

tickx 

Stand-Alone  Host  Emulator 

tick_ppmx 

Stand-Alone  Host  Emulator 

tick_scriptx 

Stand-Alone  Host  Emulator 

trav_treex 

Viewport  Configuration 
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csu 

CSC 

tst_edebug.c 

Viewport  Configuration 

tst_equery.c 

Viewport  Configuration 

tst_ereadconfig.c 

Viewport  Configuration 

tst_eupdate.c 

Viewport  Configuration 

tst_tree.c 

Viewport  Configuration 

tst_treetrace.c 

Viewport  Configuration 

u_lHTnask.c) 

Viewport  Configuration 

u_comp_2d.c 

2-D  Overlay  Compiler 

u _getm_2d.c 

2-D  Overlay  Compiler 

ujink_2d.c 

2-D  Overlay  Compiler 

u_main2d.c 

2-D  Overlay  Compiler 

u_path.c 

Viewport  Configuration 

u_rotauons.c 

Viewport  Configuration 

u_viewpoin.c 

Viewport  Configuration 

u_xfirm.c 

Viewport  Configuration 

update_2dc 

Stand-Alone  Host  Emulator 

update_agpt_2d.c 

Stand-Alone  Host  Emulator 

update_mtx.c 

Viewpat  Configuration 

update_rioLc 

Viewport  Configuration 

upstart.c 

Real-Time  Processing 

vpt_getc 

Viewport  Configuration 

vpt_process.c 

Viewport  Configuration 

vpi_query.c 

Viewport  Configuration 

vpt_set.c 

Viewport  Configuration 

vpt_update.c 

Viewport  Configuration 

vtlOO.c 

System  Utilities 

window  .c 

2-D  Overlay  Compiler 
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E.2  Data  Type  Names  Mapped  To  Typedefs 

The  following  list  shows  the  special  data  types  used  throughout  the  real-time  software,  and 
identifies  the  file(s)  that  contain  the  type  de^ition.  The  type  names  are  listed  in 
alphabetical  order. 


Data  Type 

(*MAT_PTR4)[3] 

(*MAT_PTR8)[3] 

(*pn2)o 

(*PFI4)0 

(•PFR4)0 

(*PFR8)0 

4RGBO 

AAM 

ALLOC_POLY 

ASID_OMODEL 

ASID_SHOW_EFF 

AUTOP 

B1BBOX2D 

B1BBOX3D 

BIHSL 

BIHSLO 

B1MTX4X3 

B1MTX4X4 

B1P2D 

B1P3D 

B1P4D 

BIRGB 

BIRGBO 

BACKEND_OBJ 

BOOLEAN 

BVOL_CACHE_ENTRY 

BVOL_ENTRY 

BX.MODEL 

BX_SHOW_EFF 

BX.TANK 

BYTE 

CAL_OVRLY 

CATALOG_TABLE_STRUCT 


Typedef  Location 

/cig/includ^rt_types.h 
/cigAincIude/rt_types.h 
/cig/include/dgi_adg.h,  standard.h 
/cig^clude/dgi_stdg.h,  standard.h 
/cigAnclude/dgi_stdg.h,  standard.h 
/cig/Lnclude/dgi_stdg.h,  standard.h 
/cigAinclu(k/standard.h 
/cig/include/backend.h 
/cig/include/suuct_2d  .h 
/cig/include/modeLstructh,  structures.h 
/cig/include/modeLstruct-h,  structures.h 
/cig/libsrc/ltbflea/aulopilot.c 
/cig/include/dgi_stdg.h,  standard.h 
/cig/include/dgi_stdg.h,  standard.h 
/cig/include^dgi_stdg.h,  standard.h 
/cig/includ^dgi_stdg.h,  standard.h 
/cig^uiclude/dgLstdg.h,  standard.h 
/cig/include/dgi_stdg.h,  standard.h 
/cig^mclud^dgi_stdg.h,  standard.h 
/cigAnclude/dgi_stdg.h,  standard.h 
/cig/include/dgi_stdg.h,  standard.h 
/cig/include/dgi_stdg.h,  standard.h 
/cigAnclude/dgi_stdg.h,  standard.h 
/cig^utclud^backend-h 

/cig/include/dgi_stdc.h,  rt_types.h,  standard.h; 
/cig/othersrc/force/dgi_stdc.h 

/cig/inctude/bx_structs.h 
A:ig^ncludeA>x_itdb_structs.h,  ndb_smict.h 
/cig/include/bx_rtdb_structs.h 
/cig/include/bx_rtdb_structs.h 
/cigAinclude/bx_rtdb_structs.h 

/cig/include/dgLstdc.h,  rt_types.h,  standard.h; 
/cig/othersrc/force/dgi_stdc.h 

/cig/include/overlay3d_siruct.h,  structures.h 
/cig/includcAtdb_struci.h 
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Data  Type 

CHAN_CNST 

CHAN_SETCMD 

CHORD 

CHORD.DATA 

CLOUD_CONTROL 

CMD 

CMDR_OVRLY 

COLOR.TABUE 

COMMAND.LINEl 

COMMAND_LINE2 

CONHGURATION.NODE 

DB_DIR_ENTRY 

DB_HDR 

DB_HDR_DBASE_DATA 

DB_HDR_LMARKS_DATA 

DB_HDR_OFLOW_DATA 

DB.INFO 

DB.PTRS 

DB_TAG_STRUCT 

DB_VERSION_STRUCT 

DED_POOL 

DEMOl 

DIGmZER.INTERFACE 

DTP_CMND_INF 

DTP_MODE_SWrTCH 

DTP_TRACE_STRUCT 

EDGE_FLG 

EO.EFFECTS 

EO.OVRLY 

ESIFA_DOWNLOAD_QUEUE. 

ESIFA_OBJ 

ESIFA_PORTS 

EVC 

F.SIMIN 

F_SIMOUT 

FADE_DESCR 

FADE_TRANSFER 

FAKE_DV 

FD(_BVOL_ENTRY 

FORCE_ENVIRONMENT 

FORCE.INTERFACE 


Typedef  Location 

/cigAnclude/poly_strucLh,  stnictures.h 
/cig^nclude/^]y_slnict.h,  stnictures.h 
/cig/include/bx_stTucts.h 
/cig/include/ba]_struct.h.  stnictures.h 
/cig^ncIude/clouds.h 
/cig/incIude^ly_strucLh,  structures.h 
/cig^nclude/overlay3d_stnict.h,  stnictures.h 
/cig/incIude/mpv_strucLh,  structures.h 
/cig^nclude/bx_rtdb_structs.h,  poly_strucLh,  smictures.h 
/cig/include/bx_rtdb_stnicts.h,  poly_struct.h,  structures.h 
/cig/include/vpi_viewporth 
/cig^nclude/bx_rtdb_structs.h,  rtdb_strucLh 
/cigAnclude/bx_Tidb_structs.h 
/cig/include/rtdb_stnict.h 
/cig/includ^rtdb_stnict.h 
/cig/includ^ldb_struct.h 
/cigAnclude/db_struct.h,  structures.h 
/cigAnclude/db_stnict.h,  stnictures.h 
/cig/iiiciude^b_struct.h 
/cig/include/rtdb_struct.h 
/cig/Ubsrc/lilxtl/ded_gm_pool.c,  open_dcd.c 
/cigAnclude/denio_stnict.h 
/cig/incIude/dig_stnicLh 
/cig/libsrc/librtt/ded_model_trace.c 
/cig^mcIudc/mpv_strucLh,  structures.h 
/cig/libsic/libgossip/ded_objecLc 
/cig/include/definitions.h 
/cig/^clud^structures.h 
/cig/include/stnictures.h 
STRUCT  /cig/Iibsrc/libesifa/esifa.man.c 
/cig/includ^esifa.h 
/cig/include/esifa.h 
/cig/libstc/librtt/sys_control.c 
/cig/include/denio_stnict.h 
/cig/include/deino_struct.h 
/cig/libsrc/libflca/nea_agpt_switches.c 
/cigAnclude/mpv_struct.h,  structures.h 
/cig/incIude/model_structh,  structures.h 
/cig/include/bx_rtdb_structs.h,  ildb_struct.h 

/cigAmclude^orce_cnv.h; 

/cig/othcrsrc/force/force_env.h,  force_rtsw_if.h 

/cig/includc/mbx.h; 

/cig/othersrc/forcc/force_defuies.h,  mbx.h 
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Data  Type 
FOV 

FOV_VECTORS 

FOVTT 

GENLM 

GM_DE 

GM_DIR_ENTRY_DATA 

GM_DIR_ENTRY_NAME 

GRAPHICS_PATH_PARAMETERS 

GRID_COMP_DEF 

GRID.LOC 

GUN_B 

GUN_B_LSIDE 

GUN_B_RSIDE 

GUNNER_OVRLY 

HWORD 

I2BBOX2D 

I2BBOX3D 

I2HSL 

I2HSLO 

I2U 

I2MTX4X3 

I2MTX4X4 

I2P2D 

I2P3D 

I2P3D 

I2RGB 

I2RGBO 

I4BBOX2D 

I4BBOX3D 

I4HSL 

I4HSLO 

I4D 

I4\rrX4X3 

I4MTX4X4 

I4P2D 

I4P3D 

I4P4D 

I4RGB 

I4RGBO 

INT_2 


Typedef  Location 

/cig/include/if_hdr_str.h:  cig/libsrc/libvpt/vpi_msgs.h 

/cigAnclude/vpi_viewporLh 

/cigAincIude/poIy.strucLh,  structures.h 

/cig/libsrc/lilMtl/generic_lin.c 

/cig^clude/bx_rtdb_structs.h 

/cig^IudeAtdb_stnict.h 

/cig/inctude^b_struct.h 

/cigAnclu(Wvpi_viewporth 

/cigAnclude/bx_rtdb_structs.h,  poly_stnict.h,  structures.h 
/cigAnclude/bx_rtdb_structs.h,  rtdb_strucLh 
/cig^include/overlay3d_strucLh, structures.h 
/cigAnclude/overlay3d_stiuct.h,  structures.h 
/cigAinclude/overlay3d  _struct.h,  structures.h 
/cig/include/overlay3d_struct.h,  structures.h 

/cig/include/dgi_stdc.h,  rt_types.h,  standard.h; 
/cig/othersrc/force/dgi_stdc.h 

/cig^clude/dgi_stdg.h,  standard.h 
/cig^include/dgi.stdg.h,  standard.h 
/cigAinclude/dgi_stdg.h,  standard.h 
/cig^clude/d^_stdg.h,  standard.h 
/cig/include/standard.h 
/cigAnclude/dgi_stdg.h,  standaTd.h 
/cigAuiclude/dgLstdg.h,  standard.h 
/cig/incIude/dgLstdg.h,  standard.h 
/cigAnclude/dgi_stdg.h,  rt_types.h,  standard.h 
/cig/include/dgi_stdg.h,  standard.h 
/cig/include/dgi_stdg.h,  standard.h 
/cig/include/dgi_stdg.h,  standard.h 
/cig/include/dgi_stdg.h,  standard.h 
/cig/include/dgi_stdg.h,  standard.h 
/cig/include/dgi_stdg.h,  standard.h 
/cig/include/dgi_stdg.h.  standaFd.h 
A:ig/include/standard.h 
/cigAinclude/dgi.stdg.h,  standard.h 
/cig^include/dgi.stdg.h,  standaid.h 
/cigAuiclude/dgi.stdg.h,  standard.h 
/cig^include/dgi.stdg.h,  rt_types.h,  standard.h 
/cig/includ^dgi_stdg.h,  standard.h 
/cig^iclude/dgi_stdg.h,  standaid.h 
/cig^uicIude/dgLstdg.h 

/cig/include/dgLstdc.h,  it_types.h,  standard.h; 
/cig/othersrc/force/dgi_stdc.h 
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Data  Type 

INT_4 

lOB 

LM_CACHE_ENTRY 

LM_CALL1 

LM_CALL2 

LM_H 

LM_SEARCH_LIST 

LM.STATS 

LMS_DATA 

LT_BVOL_ENTRY 

LT_POLY_ENTRY 

Ml_GUN_OVERLAY 

M2_GUN_OVERLAY 

MAT.UNTT 

MATRIX4t3][3] 

MATRIX8[3][3] 

MDL_ADDR_STRUCT 

MESSAGE.HEADER 

MODE_SELECT_STRUCT 

MODEL_TABLE_STRUCT 

MPVIDEO.CONTROL 

MPVIDEO_OBJ 

MPVIO.INTERFACE 

MSG_lROTATION 

MSG_2D_SETUP 

MSG_3ROTATIONS 

MSG_ADD_TRAJ_TABLE 

MSG_AGL 

MSG_AGL_SETUP 

MSG_AMMO_DEFINE 

MSG_B0_AAM_CENTROID 

MSG_BO_AAM_SW_CORNER 

MSG_BO_ADD_STATIC_VEfflCLE 

MSG_BO_ADD_TRAJ_TABLE 

MSG_B0_BAL_CONFIG 

MSG_B0_BVOL_ENTRY 

MSG_B0_CANCEL_ROUND 

MSG_BO_CIG_FRAME_RATE 

MSG_B0_DATABASE_INFO 

MSG_BO_DELETE_STATIC_VEHICLE 


Typedef  Location 

/cig^clud^dgLstdc.h,  rt_types.h,  standard.h; 
/cig/others-c/force/dgi_stdc.h 

/cig/Iibsrc/Iibsio/sio.c 
/cig/include/bx_structs.h 
/cig^mclude^ly_strucLh,  stnictures.h 
/cig^nclude^Iy_stnicLh,  structures.h 
/cig/include/bx_itdb_smicts.h,  rtdb_strucLh 
/cig/include/bx_structs.h 
/cigAnclude/bx_rtdb_structs.h,  ildb_strucLh 
/cigAncIiide/db_stnict.h,  structures.h 
/cig/include/if_cig2sim  .h 
/cig/include/if_cig2siin.h 
/cigAnclude/overlay3d_str\jct.h,  structures.h 
/cig^nclude/overlay3d_struct.h,  structures.h 
/cig^include/poIy_struct.h,  structures.h 
/cig^nclud^it_types.h 
/cigAncludc/rt_types.h 
/cig/libsic/Iibgossip/ded_objecLc 

/cig/incIu<teAnx_defines.h;/cig/libsrc/libgossip/mx3_hword.c; 

/cig/libsrc/iibrtl/mx2_hword.c; 

/cig/othersic/f(wce/inx2_hword.c 

/cig/othersrc^(»ce/fl_defines.h 

/cig/include/rtdb_struct.h 

/cig/include/mpvideo.h 

/cig/include/mpvideo.h 

/cig/includ^mpvideo.h 

/cig/include/if_sitn2cig.h 

/cig/incIudeAf_iniLh 

/cig/include/if_sitn2cig.h 

/cig/includc/if_sim2cig.h 

/cig/include/if_cig2siin.h 

/cig/inclu(le/if_sim2cig.h 

/cig^nclude/if_iniLh 

/cig^clude/bx_messages.h 

/cig/include/bx_messages.h 

/cig/include/bx_messages.h 

/cig/include/bx_messages.h 

/cig/include/bx_messages.h 

/cig/includ^x_messages.h 

/cig/include/bx_messages.h 

/cig/include/bx_inessages.h 

/cig/uic!ude/bx_messages.h 

/cig/uiclude/bx_messagcs.h 
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Data  Type 

MSG.BO.DELETIE.TRAJ.TABLE 

MSG_BO_LM_READ 

MSG_B0_MODEL_DIRECTORY 

MSG_B0_MODEL_ENTRY 

MSG_BO_NEW_FRAME 

MSG_BO_PRINT 

MSG_BO_PROCESS_CHORD 

MSG_BO_PROCESS_ROUND 

MSG_BO_ROUND_FIRED 

MSG_B0_STATE_CONTROL 

MSG_BO_TF_INIT_HDR 

MSG_BO_TF_INIT_PT 

MSG_BO_TF_STATE 

MSG_B0_TF_VEHICLE_POS 

MSG_B0_TRAJ_CHORD 

MSG_BO_TRAJ_ENTRY 

MSG_B  l_GLOBAL_ADDR 

MSG_B  1_HIT_RETURN 

MSG_B1_MISS 

MSG_B  l_ROUND_POSITION 

MSG_B  l_SHOT_REPORT 

MSG_B  1_STATUS_RETURN 

MSG_B1_TF_HDR 

MSG_B1_TF_PT 

MSG_CALIBRATION_IMAGE 

MSG_CANCEL_ROUND 

MSG_aG_CTL 

MSG_CLOUD_STATE 

MSG.CREATE.CONHGNODE 

MSG_DATA_TEST 

MSG_DEFINE_TX_MODE 

MSG_DELETE_TRAJ_TABLE 

MSG_DR1 1_PKT_SIZE 

MSG_PO_3DLUT_DOWNLOAD 

MSG_FO_3DLUT_SWITCH 

MSG_FO_ALLLUT_SWITCH 

MSG_FO_FINAL_LUT_DOWNLOAD 

MSG_FO_FINAL  LUT  SWITCH 


Typedef  Location 

/cig^clud^x_messages.h 

/cig/include/bx_messages.h 

/cigAndude/bx_inessages.h 

/cigAjnclude/bx_messagcs.h 

/cig/includeA)x_inessages.h 

/cig/include/bx_inessages.h 

/cig^clude/bx_messages.h 

/cig/incliKie/bx_messages.h 

/cigAnclude/bx_messages.h 

/cig/include/bx_messages.h 

/cigAuiclude/bx_inessages.h 

/cig^clude/bx_messages.h 

/cig^clude/'bx_messages.h 

/cig^includ^x_messages.h 

/cigAndude/bx_inessages.h 

/cig/indude/bx_messages.h 

/cigAndude/bx_messages.h 

/cig/mdude/bx_messages.h 

/cig/induddbx_messages.h 

/cig^mdude/bx_messages.h 

/cig^dude/bx_messages.h 

/cig/indude/bx_incssages.h 

/cig/indude/bx_messages.h 

/cig^indud^x_messages.h 

/cig/include/if_sim2cig.h 

/cig/indude/if_sim2cig.h 

/cig/indude/if_cU_err.h 

/cig/indude/if_sitn2cig.h 

/cig/indude/if_iniLh;  /cig/libsrc/libvpt/vpi_msgs.h 

/cig/indude/if_sini2cig.h 

/cig^ndude/if.iniLh 

/dg/indude/if_siin2cig.h 

/cig/iiidude^_ctl_crr.h 

/cigAndudc^fjpvideo_insg.h; 

/cig/othersrc^orce/mpvideo_msg.h 

/cig/indude/tnpvideo_msg.h; 

/cig/othcrsrc^orce/mpvideo_insg.h 

/cig/indude/mpvideo_msg.h; 

/cig/othersrcA^orceAnpvideo_msg.h 

/cig/indudeAnpvideo_nisg.h; 

/cig/othersrc/force/inpvideo_msg.h 

/cig/indudeAnpvideo_msg.h; 

/cig/othersrc/force/mpvideo_insg.h 
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Data  Type 

MSG_FO_MODE_SELECT 

MSG_FO_MPV_PEEK 

MSG_FO_MPV_POKE 

MSG_FO_MPV_POKE16 

MSG_FO_MPV_TASK_CONTROL 

MSG_FO_MPV_WRnE 

MSG_FO_PASS_ON 

MSG_FO_PIXEL_DEPTH_REQUEST 

MSG_FO_QUERY 

MSG_FO_SET_DISPLAY 

MSG_F1_ACKN0WLEDGE 

MSG_F1_FINAL_LUT_ADDR 

MSG_Fl_MPVJOCT 

MSG_F1_MPV_LUT_TYPE 

MSG_F1_MPV_MEM0RY 

MSG_F1_PIXEL_ADDR 

MSG_F1_PIXEL_DEPTH_RETURN 

MSG_F1_STATUS 

MSG_F1_TEXT 

MSG_FILE_DESCR 

MSG_FmE_STATUS 

MSG_nLE_XFER 

MSG_GUN_OVERLAY 

MSG_HDR 

MSG_Hrr_RETURN 

MSG_HIT_RETURN48 

MSG_HPRXYZS_MATRIX 

MSG_LASER_RETURN 


Typedef  Location 

/cigAncludeAnpvideo_msg.h; 

/cig/othersic/force/mpvideo_msg.h 

/cig^include/mpvideo_msg.h; 

/cig/othersrcAdrce/mpvideo_msg.h 

/cig^ncludeAnpvideo_msg.h: 

/cig/othersrc/force/mpvideo_insg.h 

/cigAnclud^pvideo_msg.h; 

/cig/oihersrc^orce/inpvideo_msg.h 

/cig/otherstc^on:e/mpvideo_msg.h; 

/cig^ncIude/mpvideo_insg.h 

/cigAncIudeAnpvideo_msg.h; 

/cig/othersrc^orceAnpvideo_msg.h 

/cig^lncl^de^^lpvideo_msg.h: 

/cig/othersrcAbrce/mpvideo_insg.h 

/cig^nclud^pvideo_msg.h; 

/cig/othersic/force/mpvideo_msg.h 

/cig/includeAnpvideo_msg.h; 
/cig/othersic/force/force_rtsw_if.h,  mpvideo_msg.h 

/cig^include^pvideo_insg.h; 

/cig/oth»sic/foice/mpvideo_msg.h 

/cig^ncIudeAnpvideo_msg.h; 

/cig/olhersrcAbrce/mpvideo_msg.h 

/cig/includeAnpvideo_msg.h; 

/cig/othersic/force/mpvideo_msg.h 

/cig/inclu(tetopvideo_msg.h; 

/cig/othcrstx:/forceAnpvideo_msg.h 

/cigAinclude/mpvideo_msg.h; 

/cig/othersic/force/mpvideo_msg.h 

/cig/include/mpvideo_msg.h; 

/cig/othersrc/forceAnpvideo_msg.h 

/cig/include/mpvideo_insg.h; 

/cig/othersrc/forcc/mpvideo_msg.h 

/cig/include/inpvideo_msg.h; 

/cig/othersic/forceAnpvideo_tnsg.h 

/cigAjnclude/mpvideo_msg.h; 

/cig/othersrc/forceAnpvideo_insg.h 

/cig^nclude^pvideo_insg.h; 

/cig/othersic/force/force_rtsw_if.h,mpvideo_msg.h 

/cig/include^f_tst_ctl.h,  sysdefs2.h 
/cig/includeflf_tst_ctl.h,  sysdefs2.h 
/cig/include^f_tst_cU.h,  sysdefs2.h 
/cig/include/if_siin2cig.h 
/cig/include/if_cU_err.h 
/cig/include/if_cig2siin.h 
/cig/inclu(te/if_rva2ncth 
/cig/include/if_sim2cig.h 
/cig/includc/if_cig2sini  .h 
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Data  Type 

Typedef  Location 

• 

MSG_LOCAL_TERRAIN 

/cig/includ^if_cig2siin.h 

MSG_LT_PIECE 

/cig/include/if_cig2sim.h 

MSG_LT_STATE 

/cig/includeAf_sim2cig.h 

MSG_MISS 

/cig/include/if_cig2sim  .h 

MSG_OBSCURE 

/cig/inc!ude/if_sim2cig.h 

MSG_OTHERVEH_STATE 

/cig/include^_sim2cig.h 

MSG_OVERLAY_SETUP 

/cig/libsrc/libvpl/vpi_msgs.h 

MSG_PASS_BACK 

/cig/include/if_cig2sim  .h 

MSG_PASS_ON 

/cig/include/if_sim2cig.h 

MSG_PPM_DISPLAY_MODE 

/cig/include/if_sim2cig.h 

MSG_PPM_DISPLAY_OFFSET 

/cig/include/if_sitn2cig.h 

MSG_PPM_PIXEL_LOCATION 

/cig/include/if_sim2cig.h 

MSG_PPM_PIXEL_STATE 

/cig/include/if_sim2cig.h 

MSG_PROCESS_CHORD 

/cig/include/if_sim2cig.h 

MSG_PROCESS_ROUND 

/cig/include/if_sim2cig.h 

MSG_PROCESS_ROUND48 

/cig/include/if_sim2cig.h 

MSG_REQUEST_LASER_RANGE 

/cig/include/if_sim2cig.h 

MSG_REQUEST_POINT_INFO 

/cig/include/if_sim2cig.h 

MSG_RETURN_POINT_INFO 

/cig/include/if_cig2siin  .h 

MSG  ROT2xl_MATRIX 

/cig/include/if_sim2cig.h 

• 

MSG_ROUND_FIRED 

/cig/include/if_sim2cig.h 

MSG_RTS4x3_MATRIX 

/cig/include/if_sim2cig.h 

MSG.SCALE 

/cig/include/if_sim2cig.h 

MSG_SHOT_REPORT 

/cig/include/if_cig2siin  .h 

MSG_SHOT_REPORT48 

/cig/include/if_rva2nei.h 

MSG_SHOW_EFFECT 

/cig/include/if_sim2cig.h 

MSG_SIO_CLOSE 

/cig/include^if_sim2cig.h 

MSG_SIO_INIT 

/cig/include/if_sim2cig.h 

MSG_SIO_WRITE 

/cig/includ^if_sim2cig.h 

MSG_STATICVEH_REM 

/cig/include/if_sim2cig.h 

MSG_STATICVEH_STATE 

/cig/include/if_sim2cig.h 

MSG_STRUCT 

/cigAinclude/cigsimio.h 

MSG_SUBSYS_MODE 

/cig/include/if_sim2cig.h 

MSG_SYS_ERROR 

/cig/include^_ctl_cir.h 

MSG_TERRAIN_FEEDBACK_POINT_INIT 

/cig/libsrc/libvpt/vpi_msgs.h 

MSG_TCRRAIN_FEEDBACK_SETUP 

/cig/libsrc/libvpt/vpi_insgs.h 

MSG_TEST_NAME 

/cig/include^jf_tsl_cU.h 

MSG_TF_HDR 

/cig/includ^if_ctg2siin  .h 

MSG_TF_INIT_HDR 

/cig/include/if_sim2cig.h 

MSG_TF_INIT_PT 

/cig/include/if_sim2cig.h 

• 

MSG_TF_PT 

/cig/include/if_cig2siiTi  .h 

MSG_TF_PT48 

/cig/mclude/if_rva2nct.h 

829 


BBN  Systems  and  Technologies 


GTIOO  RTSW  CSCI 


Data  Type 

Typedef  Location 

MSG_TF_STATE 

/cig^inclu(le/if_sim2cig.h 

MSG_TF_VEHICLE_POS 

/cig/include/if_sim2cig.h 

MSG_TRAJ_CHORD 

/cig/include/if_sim2cig.h 

MSG_TRAJ_ENTRY 

/cig/include/if_siin2cig.h 

MSG_TRAJ_ENTRY_XFER 

/cig/include/if_inith 

MSG_TRAJ_TABLE_XFER 

/cigAncludeAf.inith 

MSG.TRANSLATION 

/cig^c!ude^_siin2cig.h 

MSG_VIEW_FLAGS 

/cig/include/if_sini2cig.h 

MSG_VmW_MAGNinCATION 

/cig/include/if_sim2cig.h 

MSG_VlEWPORT_STATE 

/cig^ncIude/if_iniLh 

MSG_VEWPORT_STATE 

/cig/libsrc/libvpt/vpi_msgs.h 

MSG_VIEWPORT_UPDATE 

/ci  g/include/if_siin2cig.h 

MSGS.BLK 

/cig/inclu<Wif_ctl_err.h 

MTXUNION 

/cig/include/if_hdr_str.h,  vpi_struct.h 

MX2_DEVICE 

/cig/libsrc/libgossip/mx3_hword.c ; 

/cig/libsrc/Iibrll/mx2_hword.c; 

/cig/othersrc/force/mx2_hword.c 

MX_DEVICE 

/cigAincIude/inx_defines.h 

OMODEL 

/cig/include/modeLstiucLh,  structures.h 

OVERLAY_PARAMS 

/cigAnclude/oveilay3d_struct.h 

POI 

/cigAnclude/denio_stnict.h 

POINT_DATA 

/cig/includeybx_structs.h 

POLY_CACHE_ENTRY 

/cig/include/bx_strucu.h 

POLY.ENTRY 

/cig/include/bx_stnicts.h 

POLY_INFO_WORD 

/cigAnclude^x_rtdb_structs.h,  poly_sirucl.h,  structures.h 

POLYGON.LIST 

/cigAinclude/bx_rtdb_stnicts.h,  poly_strucLh,  structures.h 

PPM_DATA_TYPE 

/cig/include^pm.h 

PREAMBLE 

/cig/libsrc/Ubhostyhost_enet_if.c 

PRINT_MSG_STRUCT 

/cig/libsrc/Iibhosl/host_if_debug.c; 

/cig/libsrc/libmsg/print_msg.c 

PROJ_DATA 

/cig/includc/bal_struct.h,  structures.h 

PROJ_DATA_2 

/cig/includQ/baJ_struct.h,  structures.h 

R4BBOX2D 

/cig^clude/dgi_stdg.h,  standard.h 

R4BBOX3D 

/cig/include/dgi_stdg.h,  standard.h 

R4HSL 

/cig/include/dgi_stdg.h,  standard.h 

R4HSLO 

/cigAuicIude/dgi_stdg.h,  standard.h 

R4U 

/cig/include/standard.h 

R4MTX4X3 

/cig/include/dgi_stdg.h,standard.h 

R4MTX4X4 

/cig/tnclude/dgi_stdg.h,standard.h 

R4P2D 

/cig/include/dgLstdg.h, standard.h 

R4P3D 

/cig/include/dgi_stdg.h4l_types.h,  standard.h 

R4P4D 

/cig/include/dgi_stdg.h,  standard.h 

R4RGB 

/cig/include/dgi_stdg.h,  standard.h 
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Data  Type 

Typedef  Location 

R4RGBO 

/cig^include/dgi_stdg.h,  standard.h 

R8BBOX2D 

/cig/include/dgi_stdg.h,  standard.h 

R8BBOX3D 

/cigAnclude/dgi_stdg.h,  standard.h 

R8HSL 

/cigAinclude/dgLstdg.h,  standard.h 

R8HSLO 

/cig/include/dgi_stdg.h,  standard.h 

R8MTX4X3 

/cigAncliide/dgi_stdg.h,  standard.h 

R8MTX4X4 

/cig/include/dgi_stdg.b,  standard.h 

R8P2D 

/cig/include/dgi_stdg.h,  standard.h 

R8P3D 

/cigAinclude/dgi_stdg.h,  standard.h 

R8P4D 

/cig^clude/dgi_stdg.h,  standard.h 

R8RGB 

/cig/include/dgi_stdg.h,  standard.h 

R8RGBO 

/cigAinclude/dgi_stdg.h,  standard.h 

RCL_UNION 

/cig/inclu(k^include.h 

REAL_4 

/cig/include/dgi_stdc.h,  n_types.h,  standard.h; 
/cig/othersrc/force/dgi_stdc.h 

REAL_8 

/cig/include/dgi_stdc.h,  rt_types.h,  standard.h; 
/cig/othersrc/force/dgLstdc.h 

RESOLUTION 

/cig/include/if_hdr_str.h;  /cig/libsrc/libvpi/vpi_msgs.h 

RGBPOLY_LIST 

/cig/include/^Iy_strucLh,  structurcs.h 

ROT2xl_MTX 

/cig/include/if_hdr_str.h,  vpi_slnict.h 

ROUND.DATA 

/cig/include/bx_stnicts.h 

RTS3x3_MTX 

/cig/include/if_hdr_str.h,  vpi_struct.h 

RTS4x3_MTX 

/cig/include/if_hdr_str.h,  vpi_struct.h 

SCREEN 

/cig/include/vpi_vicv\'porth 

SCREEN_POSIT10N_STRUCT 

/cig/libsrc/libflea/tick_ppm  .c 

SCRN_CONSTANTS 

/cig/include/vpi_viewporth 

SEARCH_LIST 

/cig/includ^dennitJons.h 

SG_OVERLAY_SETLTP 

/cig/incIude/if_iniLh 

SHORT_LONG_ADDR 

/cig/libsrc/Iibmpvideo/bootfoTce.c 

SHOW_EFF 

/cig/include/model_structn,  struclures.h 

SIM_VEH_STRUCT 

/cigAinclude/dcmo_strucl.h 

SIO.CTL 

/cig/libsrc/Iibsio/sio.c 

SOMODEL 

/cig/include/model_strucLh,  structures.h 

SREM 

/cig/includeAnodel_struct.h3tructures.h 

STAMP.LIST 

/cig/include/poly_structh,  structures.h 

STANK 

/cig/include/model_strucLh,  structures.h 

STAT_VEH 

/cig/include/bx_structs.h 

STRING 

/cigAncludc/standard.h,  dgi.stdc.h; 
/cig/othersrc/force/dgi_stdc.h 

STRUCT2D 

/cig/include/struct_2d.h 

STRUCT_P_BVOL 

/cig/include/bx_structs.h 

STRUCT_P_POLY 

/cig/include/bx_strucLs.h 

STRUCT.P.ROLTrt) 

/cig/includeA)x_strucls.h 
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Data  Type 

STRUCT_P_SV 

STRUCT_P_TF_PT 

SWITCH_2DLUT_STRUCT 

T_MATRIX[3][3] 

T_VECTOR[3] 

TABLEl 

TAC.STATUS 

TANK 

tasks 

TERRAIN_CORNERS 

TEXTURE_INDEX 

TEXTURE_MAP 

TFl 

TF2 

TF_DATA_HDR 

tfpt 

TF_TYPE 

TRAJ.DATA 

TRAJ_DATA_2 

TRAJ.ENTRY 

TRAJ_POS 

TRAJ_POS_2 

TRAJ.TABLE 

UIR4P 

UIR4P3D 

UNS_1 

UNS.'’ 

UNS_4 

V_FLAGS 

VECTOR4[3] 

VECTOR8[3] 

VIDEO_CONTROL 

VIEWPORT_PARAMETERS 

VPPOS_ARRAY 

VPT_CNODE_INFO 

VPT_PATH_INFO 

VPT_VPT_INFO 

WHERE.PROCESS 

WINDOW_DESCRIPTOR_TABLE 


Typedef  Location 

/cig/include/bx_structs.h 

/cig/libsrc/libball/bx_tf_pack.c 

/cig/othcrsrc^orce/fl  _(lefines.h 

/cig/incIud^vpi_strucLh 

/cig/incIude/vpi_stnicLh 

/cig/Iibsrc/libflea/flea_agpt_switches.c 

/cig^clude/definitions.h 

/cig/incliide/model_stnicth,  structures.h 

/cig/include/sysdefs2.h 

/cig/include/bx_stnicts.h 

/cig/include/slnictures.h,  traverse_cmd_defs.h 

/cig^nclude/poly_strucLh,  structures.h 

/cigAnclude/U'_hdr_str.h 

/cig/includcAf_hdr_str.h 

/cig/include/bx_stnicts.h 

/cig/libsrc/Iibbaliybx_tf_pack.c 

/cig/include^f_hdr_str.h;  /cig/libsrc/libvpi/vpi_msg5.h 

/cig/include/bal_struct.h,  structures.h 

/cig/include/bal_struct.h,  structures.h 

/cig/include/bx_structs.h 

/cig/include/bal_siruct.h,  stmctures.h 

/cig/include/bal_struct.h,  structures.h 

/cig/include/bx_structs.h 

/cig/include/standard.h,  structures.h 

/cig/include/standard.h,  structures.h 

/cig/include/dgi_stdc.h,  /standard.h; 
/cig/othersrc/force/dgi_stdc.h 

/cig^include/dgLstdc.h,  standard.h; 
/cig/othersrc/fOi'Cc/dgi_stdc  .h 

/cigAnclud^dgLstdc.h,  standard.h; 
/cig/othersrc/forcc/dgi_stdc.h 

/cig^mcIude/vpi_viewporLh 
/cig^nclud^it_types.h 
/cigAincludeM_types.h 
/cig/inclutle/mpv_strucLh,  structures.h 
/cig/includ^vpi_viewporth 
/cig/incIude/vpi_viewporth 
/cig/include/vpi_query.h 
/cigA»nclud^vpi_query.h 
/cig^nclude/vpLqucry.h 
/cig/include/ecompilerl  .h 
/cig/include/struct_2d.h 
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Data  Type 

WORD 

X'ZHPR 


Typedef  Location 

/cig/include/dgi_sldc.h.  rt_types.h,  standard.h; 
A:ig/olhersrc/force/dgi_sUlc.h 

/cig/includeZif_hdr_str.h 
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E.3  Function  Names  Mapped  To  Source  File  Locations 

The  following  list  shows  each  function  in  the  real-time  software,  and  identifies  the  file  in 
which  the  function  is  located.  The  third  column  shows  the  section  number  in  which  the 
function  is  described  in  this  document 


Function  Name 

Location 

Section 

_copy_reconfigurable_viewports_section 

/cig/libsrc/libmsg/msg_end.c 

2.12.6.13 

_database_disable 

/cig/libsrc/libmsgAnsg_cnd.c 

2.12.6.10 

_display_lights 

/cig/libsrc/libinsg/msg_end.c 

2.12.6.3 

_downcount_effects 

/cig/libsrc/libmsgAnsg_end.c 

2.12.6.2 

_l»andJe_point_lights 

/cig/libsrc/libinsg/msg_cnd.c 

2.12.6.11 

_hancile_requestJocal_terrain 

/cig/libsrc/Iibinsg/insg_end.c 

2.12.6.9 

_move_load_module_s4)_to_quad_buffer 

/cig/libsrc/libinsg/msg_end.c 

2.12.6.4 

_pend_on_frame_inte'T'jpt 

/cig/libsrc/libinsg/msg_end.c 

2.12.6.6 

_process_agl 

/cig/libsrc/libmsg/msg_end.c 

2.12.6.7 

_reset_model_pointers 

/cig/libsrc/libmsg/msg_end.c 

2.12.6.12 

_rowcoLrd 

/cig/libsrc/librtt/rowcoLrd.c 

2.13.40.5 

_rowcol_rd_cleanup 

/cig/libsrc/librtt/rowcol_rd.c 

2.13.40.10 

_set_up_for_next_£rame 

/cig/libsrc/libinsg/msg_end.c 

2.12.6.8 

_update_second_active_area_memory 

/cig/libsrc/libmsg/msg_end.c 

2.12.6.5 

aam_fTee 

/cig/libsrc/libvpt/be_stubs.c 

2.17.1.9 

aam_malloc 

/cig4ibsrc/libconfig/aain_manager.c 

2.5. 1.1 

active_area_init 

/cig/libsrc/libbackend/aa_init.c 

2.3. 1.1 

addr_injK)ol 

/cig/libsrc/libnt/ded  _gm_pool.c 

2.13.15.3 

agpi_init 

/cig/libsrc/librtt/agptjnit.c 

2.13.1 

agpt_siatistics 

/cig/libsrc/Iibgossip/ 

2.9.1 

autopilot 

/cig/libsrc/libflea/autopilot.c 

2.7.1 

bO_aani_centroid 

/cig/libsrc/bbball/bO_aani_centroid.c 

2.4.2. 1 

bO_aam_sw_comer 

/cig/Ubsrc/libball/bO_aam_sw_comer.c 

2.4.2.2 

bO_add_static_vehicle 

/cig/libsrc/libball/bO_add_static_vehicle.c 

2.4.2.3 

bO_add_traj_table 

/cig/libsrc/libball/bO_add_traj_table.c 

2.4.2.4 

bO_bal_config 

/cig/libsrc/libbaIiybO_bal_config.c 

2.4.2.5 

bO_bvol_entry 

/cig/libsrc/libball/bO_bvol_entry.c 

2.4.2.6 

b0_cancel_n3und 

/cig/libsrc/libbalI/bO_cancel_round.c 

2A.2.1 

bO_cig_firame_rate 

/cigAibsrc/libba]l/bO_cig_frame_rate.c 

2.4.2.8 

bO_databaseJnfo 

/cigAibsrc/libball/bO_database_info.c 

2.4.2.9 

bO_delete_static_vehicle 

/cig/libsrc/libball/bO_delete_static_vehicle.c 

2.4.2.10 

bO_delete_oaj_table 

/cig/libsrc/libball/bO_delete_traj_table.c 

2.4.2.11 

bO_error_detected 

/cig/bbsrc/libball/bO_crrtM'_detected.c 

2.4.2.12 

bO_inapp_message 

/cig/libsrc/Iibball/bO_inapp_inessage.c 

2.4.2.13 

bO_lin_read 

/cig/libsrc/libball/bO_lm_read.c 

2.4.2.14 

bO_model_directory 

/cig/libsrc/libball/bO_inodel_directory.c 

2.4.2.15 

bO_inodel_entry 

/cig/libsrc/libball/bO_model_entry.c 

2.4.2.16 

bO_new_frame 

/cig/libsrc/libball)bO_new_fraine.c 

2.4.2.17 

bO_print 

/cig/libsrc/libball/bO_print.c 

2.4.2.18 

bO_process_chord 

/cig/libsrc/Iibball/bO_process_chord.c 

2.4.2.19 

bOjH'Ocessjound 

/cig/libsrc/libball/bO_proccss_round.c 

2.4.2.20 

bO_round_fired 

/cig/libsrc/bbball/bO_round_fired.c 

2.4.2.21 

bO_staie_control 

/cig/libsrc/libball/bO_state_control  .c 

2.4.2.22 

bO_statias_request 

/cig/libsrc/libbaU/bO_status_request.c 

2.4.2.23 

bO_tf_init_hdr 

/cig/libsrc/libball/bO_tf_init_hdr.c 

2.4.2.24 

bO_tf_init_pt 

/cig/libsrc/libball/bO_tf_init_pt.c 

2.4.2.25 

bO_tf_state 

/cig/libsrc/libbal  l/bO_tf_siatc.c 

2.4.2.26 

bO  tf_vehiclc_pos 

/cig/libsrc/libbalI/bO_tf_vchiclc_pos.c 

2.4.2.27 
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Function  Name 

Location 

Section 

bO_traj_chord 

/cig/libsrc/libbaliybO_traj_chord.c 

2.4.2.28 

bO_traj_entry 

/cig/libsr(^bball/bO_traj_entry.c 

2.4.2.29 

bO_undefined_message 

/cig/libsrc/libbalVbO_undefined_message.c 

2.4.2.30 

backend_clear_laser_requests 

/cig/Iibsrc/Iibbackend/backend_man.c 

2.3.5.6 

backend_get_object_addr 

/cig/libsrc/libbackend/backend_man.c 

2.3.5.5 

backend_laser_request_range 

/cig/libsrc/libbackend/backend_laser.c 

2.3.4.1 

backend.reset 

/cig/libsic/libbackend/backend_inan.c 

2.3.5.2 

backend.iesponse 

/cig/libsrc/libbackend/backend_laser.c 

2.3.4.2 

backend_send_req 

/cig/Ubsic4ibbackend/backend_inan.c 

2.3.5.4 

backend_set_lHanch 

/cig/libsic/libbackend/backend_bianch.c 

2.3.2 

backend_set_color 

/cig/libsrc/libbackend/backend_col(H'.c 

2.3.3 

backend_set_paths 

/cig/libsic/libbackend/backend_paths.c 

2.3.6.1 

backend_set_thermal 

/cig/libstc/libbackend/backend_thennal.c 

2.3.7 

backend_set_video 

/cig/libsn:/libbackend/backend_video.c 

2.3.8 

backend_setup 

/cig/Iibsrc/libbackend/backend_inan.c 

2.3.5.1 

backend_sim_init 

/cig/libsrc/libbackend/backend_inan.c 

2.3.5.3 

backend_update_view_paths 

/cig/libsic/Iil^}ackend/backend_paths.c 

2.3.6.2 

bal_buffer_setup 

/cig/libsrc/librtt/config_ballistics.c 

2.13.10.2 

bal  _get_db_pos 

/cig/libsrc/librtt/bal_get_db_pos.c 

2.13.2 

bal_get_lm_grid 

/cig/libsrc/librtt/bal_get_lm  _grid.c 

2.13.3 

ball_effect_add 

/cig/libsrc/Iibrtt/ball_effect_add.c 

2.13.5 

bbnctype 

/cig/libsrc/libconfig/bbnctype.c 

2.5.2 

be_query_buffer_offset 

/cig/libsrcAibvpt/be_stubs.c 

2.17.1.3 

be_query_dbO 

/cig/libsrc/libvpt/be_stubs.c 

2.17.1.4 

be_query_lm_per_linb_side 

/cig/libsrc/libvpi/be_stubs.c 

2.17.1.6 

be_query_numj3aths 

/cig/libsrc/libvpt/be_stubs.c 

2.17.1.1 

be_qulm 

/cig/libsrc/iibvpiybe_stubs.c 

2.17.1.5 

blank 

/cig/libsrc/libulil/vtlOO.c 

2.16.7.6 

blcop> 

/cig/libsrc/libutiVblcopy.c 

2.16.1 

booiforce 

/cig/libsrc/libmpvideo/bootforce.c 

2.11.1.1 

bx_bvoLint 

/cig/Iibsrc/libball/bx_bvoLint.c 

2.4.3.1 

bx_chord_intersect 

/cig/libsrc/libball/bx_chord_intersecLc 

2.4.3.2 

bx_deIete_round 

/cig/libsrc/libball/bx_functions.c 

2.4.3.5.2 

bx_delete_stat_veh 

/cig/libsrc/libball/bx_functions.c 

2.4.3.5.10 

bx_dist_sq_pt_Iine 

/cig/libsrc/libball/bx_funcuons.c 

2.4.3.5.11 

bx_find_round_hit 

/cig/Iibsrc/libbalVbx_compute_round.c 

2.4.3.3.5 

bx_find_shot_report 

/cig/libsrc/libbaIVbx_c(Hnpute_round.c 

2.4.3.3.3 

bx_find_vehicle 

/cig/libsrc/libball/bx_find_vehicle.c 

2.4.3.4 

bx_firee_lin_cache 

/cig/libsrc/libball/bx_functions.c 

2.4.3.5.6 

bx_get_chord_end 

/cig/libsrc/libball/bx_functions.c 

2.4.3.5.4 

bx_get_db_pos 

/cig/libsrc/libball/bx_functions.c 

2.4.3.5.3 

bx_get_lb_froin_lm 

/cig/libsrc/libball/bx_funcuons.c 

2.4.3.5.8 

bx_get_lin_data 

/cig/libsrc/libball/bx_gei_ln’._data.c 

2.4.3.6 

bx_getjin_grid 

/cigAibsrc/libball/bx  _getjm_grid.c 

2.4.3.7 

bx_guntip_within_db 

/cig/libsrc/libbalVbx_compute_round.c 

2.4.3.3.2 

bx_init 

/cig/libsrc/libball/bx_iniLc 

2.4.1. 1 

bx_inodeLint 

/cig/libsrc/libball/bx_model_int.c 

2.4.3.8 

bx_new_bvol 

/cig/Iibsrc/iibball^x_functions.c 

2.4.3.5.5 

bx_newjx)iy 

/cig/libsrc/libball/bx_funcuons.c 

2.4.3.5.7 

bx_new_round 

/cig/libsrc/libball/bx_functions.c 

2.4.3.5.1 

bx_new_sta:_veh 

/cig/libsrc/libbalVbx_functions.c 

2.4.3.5.9 

bx_polyJnt 

/cig/libsrc/libball/bx_poly_int.c 

2.4.3.9 

bx_probe 

/cig/libsrc/libbalIA>x_probc.c 

2.4. 1.2 

bx_reset 

/cig/libsrc/libball/bx_rescl,c 

2.4.1.3 

bx_retuni_niiss 

/cig/3ibsrc/libbalJ/1)x_compute_round.c 

2.4.3.3.1 

bx_round_tracer_position 

/cig/libsrc/libbaU/bx_compute_round.c 

2.4. 3.3.4 

bx_task 

/cig/libsrc/Iibball/bx_task.c 

2.4. 1.4.1 

bx_task_cleanup 

/cig/libsrc/!ibballA)x_task.c 

2.4. 1.4.2 
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bx_tf_copy_msg 

/cig/libsrc/libball/bx_tf_pack.c 

2.4.3.10.4 

bx_tf_free_tf_pts 

/cig/libsrc/libbalVbx_tf_pack.c 

2.4.3.10.7 

bx_tf_initjpt_cache 

/cig/libsrc/libballA»x_tf_pack.c 

2.4.3.10.1 

bx_tf_new_tf_pts 

/cig/libsrQdibbaH/bx_tf_pack.c 

2.4.3.10.6 

bx_tf_next 

/cig/libsrc/libball/bx_tf_pack.c 

2.4.3.10.3 

bx_tf _pt_data 

/cig/libsrQ^bball/bx_tf_pack.c 

2.4.3.10.5 

bx_tf_pts 

/cig/libsrc/libball/bx_tf_pack.c 

2.4.3.10.2 

bx_trajectory 

/cig/libsrc/libball/bx_trajectory.c 

2.4.3.11 

cal 

/cig/libsrc/librtl/cal  .c 

2.13.6 

cancel_iound 

/cig/libsrc/Ubflea/encode_routines.c 

2.7.4.28 

check_restart 

/cig/gtbinsrc/rtt/rtt.c 

2.1.3.2 

check_sum 

/cigAibsrc/Ubutil/sload.c 

2.16.5.4 

cig_2d_setup 

/cig/libsrcvlib2d/cig_2d_setup.c 

2.2.2 

Cig_COTfig 

/cig/libsrc/libconfig/cig_conhg.c 

2.5.3 

cigsimio_buffer_init 

/cig/libsrc/libra/cigsimio_obj.c 

2.13.7.6 

cigsimio_firame_aid 

/cig/libsrc/librtl/cigsimio_obj.c 

2.13.7.7 

cigsimio_get_data 

/cig/libsrc/libra/cigsiinio_obj  .c 

2.13.7.5 

cigsitnio_msg_in 

/cig/libsrc/librtt/cigsiinio_obj.c 

2.13.7.2 

cigsiinio_msg_out 

/cig/libsrc/librtl/cigsimio_obj.c 

2.13.7.3 

cigsitnio_write 

/cig/libsrc/librU/cigsiinio_obj.c 

2.13.7.4 

clear 

/cig/Ubsrc/libbackend/aa_iniLc 

2.3. 1.2 

clear_line 

/cig/libsrc^bhosl^ost_if_debug.c 

2.10.4.5 

close_db 

/cig/libsrc/librtt/close_db.c 

2.13.8 

CloseDir 

/cig/libsrc/Iibutil/directory.c 

2.16.2.3 

cloud_init 

/cig/libsrc/libitt/clouds.c 

2.13.9.1 

cloud_mgmt 

/cig/libsrc/librtt/clouds.c 

2.13.9.4 

cloud_placement 

/cig/libsrc/Iibrtt/ciouds.c 

2.13.9.5 

ckxid.scud 

/cig/libsrc/librtt/clouds.c 

2.13.9.6 

cloud_updaie 

/cig/libsTQ^bitt/clouds.c 

2.13.9.2 

cloud_»qxlaie_model 

/cigAibsrc/libra/clouds.c 

2.13.9.3 

compare_buffers 

/cig/othersrc/face/fOTcetask.c 

2.18.32.2 

compile_2d  (CIG  version) 

/cig/libsrc/lib2d/cig_comp_2d.c 

2.2.3 

compile_2d  (offline  version) 

/cig/libsr(^b2d/u_comp_2d.c 

2.2.15 

concat_mlx 

/cig/libsrc/libvpt/mu_concat.c 

2.17.11 

conflg_ballistics 

/cig/libsrc/lilHtt/conrig_ballistics.c 

2.13.10.1 

config_color_table 

/cig/libsrc/librtt/config_color_table.c 

2.13.11 

config_database 

/cig/libsrc/lil^conrig_database.c 

2.13.12.1 

config_translator 

/cig/libsrc/libflea/cLtranslator.c 

2.7.2. 1 

ctoi 

/cig/libsrc/libutil/sload.c 

2.16.5.7 

cup 

/cig/libsrc/libulil/vt  1  OO.c 

2.16.7.1 

data_type 

/cig/othersrc/force/data_type.c 

2.18.1 

db_nicc_setup 

/cig/libsrc/lil»tt/db_mcc_setup.c 

2.13.13 

debug_initdr 

/cig/libsrc/librtt/debug_initdr.c 

2.13.14 

ded_add_efifect 

/cig/libsrc/libgossip/ded_object.c 

2.9.3.4 

dBd..add_niodel 

/cig/libsrc/libgossip/ded_object.c 

2.9.3.3 

ded_adjust_addr_tables 

/cig/libsrc/libg(Ksip/ded_object.c 

2.9.3.6 

ded_ciDss_bOTder 

/cig/libsrcAibgossip/ded_object.c 

2.9.3.9 

ded_dlp_trace 

/cig/libsrchibgossiiVded_object.c 

2.9.3.12 

ded_init_mdl_addr 

/cig/libsrc/libgossip/ded_object.c 

2.9.3.2 

ded_load_dlp_code 

/cig/libsrc/libgossip/ded_object.c 

2.9.3.13 

ded_nKxld_end_addr 

/cig/libsr(^bgossip/ded_object.c 

2.9.3.5 

ded_model_ofTset 

/cig/libsrc/libgossip/ded_object.c 

2.9.3.14 

ded_modeJ_trace 

/cig/libsrc/libtU/ded_inodel_trace.c 

2.13.16 

ded_objeci_dcbug 

/cig/libsrc/libgossip/ded_object.c 

2.9.3.16 

dcd_print_tab’ s 

/cig/libsrc/libgossip/ded_object.c 

2.9.3.15 

ded_process  .directory 

/cig/libsrc/libgossip/ded_object.c 

2.9.3.11 

ded_relocaifc_modcl 

/cig/libsrc/libgossip/dcd_object.c 

2.9.3.10 

ded_setup 

/cig/libsrc/libgossip/dcd_object.c 

2.9.3.1 
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ded_sub_end 

/cig/libsrc/libgossip/ded_object.c 

2.9.3.8 

ded_uninit 

/cig/libsrc/libgossip/ded_object.c 

2.9.3.7 

dencr 

/cig/libsrc/libnea/flea_agpt_switches.c 

2.7.8.7 

disable_restart 

/cig/gtbinsicMt/ra.c 

2.1.3.3 

display 

/cig/libsrc/libgossip/dq)_emu.c 

2.9.4 .2 

dl_setup 

/cig/Ubsrc/Iibback^d/dl.manx 

2.3.9 

dl_setup 

/cig/libs«^ibru/dl_inan.c 

2.13.17 

double_bot 

/cig/libsrc/libutil/vtlOO.c 

2.16.7.4 

double_lite 

/cig/Ubsrc/Iibgossip/replace_mod.c 

2.9.18.3 

double_off 

/cig/libsr<^ibutil/vtl  OO.c 

2.16.7.5 

double_top 

/cig/libsrc/libutil/vtlOO.c 

2.16.7.3 

downloadjbvols 

/cig/libsrc/libru/download_bvols.c 

2.13.18 

dtp_compiler 

/cig/libsrci^bgendq5/dtp_compiler.c 

2.8.1 

dip_emu 

/cig/libsrc/libgossip/dtp_emu.c 

2.9.4. 1 

dtp_malloc 

/cig/Iibsrc/Iibgendq)/dq)_funcs.c 

2.8.2.5 

dtp_malloc_init 

/cig/libsrc/libgendtp/dq)_funcs.c 

2.8.2.6 

dtp_travl 

/cig/libsrc/libgendq)/dq)_travl  .c 

2.8.3 

dtp_trav2 

/cig/libsrc/libgendtp/dq>_trav2.c 

2.8.4 

dynamic_aain_init 

/cig/libsrc/libconfi^aain_inanager.c 

2.5. 1.4 

dynamic_demo 

/cig/libsrc/libflea/dynamic_demo.c 

2.7.3 

cffect_downcx3unt 

/cig/libsrc/librtl/effect_downcount.c 

2.13.19 

OTOTS 

/cig/libsrc/libra/conrig_database.c 

2.13.12.2 

esifa_ConfigData 

/cig/libsrcAibesifa/esifa_man.c 

2.6.4.5 

esifa_download 

/cig/libstc/bbesifa/esifa_query.c 

2.6.5.5 

esifa_get_object_addr 

/cig/libsrc/Iibesifa/esifa_man.c 

2.6.4.4 

esifa_laser_request_range 

/cig/libsrc/libesifa/esifa_laser.c 

2.6.2.1 

esifa_laser_retuni 

/cig/libsrc/libesifa/csifa_laser.c 

2.6.2.2 

esifa_k)ad 

/cig/libsrc/libesifa/esifaJoacLc 

2.6.3 

esifa_queue_data 

/cig/libsrc/Iibesifa/esifa_inan.c 

2.6.4.6 

csifa_queue_downIoad 

/cig/libsrc/libesifa/esifa_man.c 

2.6.4.7 

esifa.read 

/cig/libsrc/Iibesifa/esifa_quCTy.c 

2.6.5.3 

esifa_read_ports 

/cig/libsrc/Iibesifa/esifa_query.c 

2.6.5.1 

esifa_send_queue 

/cig/Ubstc/libesifa/esifa_man.c 

2.6.4.8 

esifa_send_req 

/cig/libsrc/libesifa/esifa_inan.c 

2.6.4.3 

esifa_set_fade 

/cig/Ubsrc/Iibesifa/esifa_fade.c 

2.6.1 

esifa_set_^)ecial 

/cig/libsrc/Ubesifa/esifa_special.c 

2.6.6 

esifa_set_thennal 

/cig/libsrc/libesiWesifa_thennal.c 

2.6.7 

esifa_set_video 

/cig/libsrc/Ubesifa/esifa_video.c 

2.6.8 

esifa_setup 

/cig/libsic/Iibesifa/esifa_inan.c 

2.6.4.1 

esifa_sim_inil 

/cig/libsn:/libesifa/esifa_man.c 

2.6.4.2 

esifa_write 

/cig/libsrc/libesifa/esifa_query.c 

2.6.5.4 

esifa_write_ports 

/cig/libsic/libesifa/csifa_query.c 

2.6.5.2 

excep_init 

/cig/othersrc/force/exception^m 

2.18.2.1 

exchmge_drl  l_data 

/cigAibsrcAibhost/host_drl 

2.10.1.2 

exchange_drl  l_data_siin 

/cig/libsrcidibhosl1iost_drl 

2.10.1.3 

exchange_enet_data 

/cig/libsrc/libhost/host_enel_if.c 

2.10.2.2 

exchange_enet_data_siin 

/cig/Iibsrc/libhost/host_cnet_if.c 

2.10.2.3 

exchange_flea_daia 

/cig/libsrc/libhosl/host_nea_if.c 

2.10.3.2 

exchange_inpv_data 

/cig/libsrc/libhost^ost_inpv_if.c 

2.10.5.2 

exchange_mpv_data_sim 

/cig/libsrc/Iibhostyhost_mpv_if.c 

2.10.5.3 

exchange_scsLdata 

/cig/libsrc/libhost/host_scsi_if.c 

2.10.6.2 

exchange_scsi_data_siin 

/cig/libsrc/libliost/host_scsi_if.c 

2.10.6.3 

exchange_socket_data 

/cig/libsrcAibhost/host_sockel_if.c 

2.10.7.2 

exchange_socket_data_sim 

/cig/libsrcAibhost/hosl_socket_if.c 

2.10.7.3 

extended_ram_available 

/cig/libsrcAibbackend/aa_iniLc 

2.3.1.3 

fD_3dlul_download 

A:ig/odiersrc/force/fD_3dlut_download.c 

2.18.3 

fD_3dlut_swilch 

/cig/othersrc/force/ro_3dlul_switch.c 

2.18.4 

fO_alllut_swiich 

/cig/othersrc/force/fO_alllut_switch.c 

2.18.5 
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fO_debug_disable 

/cig/othersrc/force/fO_debug_disable.c 

2.18.6 

fD_debug_enable 

/dg/othersrc/force/fO_debug_enable.c 

2.18.7 

fO_final_lut_download 

/cig/othersrc/force/fO_final_lut_download.c 

2.18.8 

fO_final_lut_switch 

/cig/othersrc/force/ro_final_lut_switch.c 

2.18.9 

fO_mode_select 

/cig/'othersrc/faice/fO_mode_selectc 

2.18.10 

fO_mpv_init 

/cig/othersrc/force/fO_mpv_iiiit.c 

2.18.11 

fO_mpv_lut_type_request 

/cig/othersic^orc^TOi_mpv_lut_type_requesLc 

2.18.12 

fO_mpv_peek 

/cig/othetsrc/forcc/fD_mpv_pedc.c 

2.18.13 

fO_mpv_poke 

/cig/othersic/forcc/fD_inpv_pdce.c 

2.18.14 

f0_mpv_pokel6 

/cig/othersrc^OTce/fD_inp  v_poke  1 6.c 

2.18.15 

fO_nipv_reset 

/cig/othCTsrc/forc^TO_mpv_reset.c 

2.18.16 

fO_inpv_task_control 

/cig/othersrc/foic^fD_inpv_task_control  .c 

2.18.17 

fO_mpv_test 

/cig/othCTsrc/force/fO_inpv_tesLc 

2.18.18 

fO_mpv_write 

/cig/othersrc/fon;^fO_mpv_write  x 

2.18.19 

fO_pass_on 

/cig/othersrc/force/fO_pass_onx 

2.18.20 

fO_pixel_depth_request 

/cig/othersrc/foice/fD_pixel_depth_requestx 

2.18.21 

fO_query 

/cig/othersrc/force/ro_queryx 

2.18.22.1 

fO_set_display 

/cig/othersrc/forcc/fD_set_displayx 

2.18.23 

fO_trigger 

/cig/othersrc/forc^_trigger  x 

2.18.24 

fO_unknown 

/cig/othersrc/force/fD_unknown  x 

2.18.25 

fl_force_init 

/cig/othersrcAbice/fl_force_init.c 

2.18.26 

fl  initjump  table 

/cig/othersrc/force/fl_initJuinp_tablex 

2.18.27 

fl_pa_320x240_h 

/cig/othersrcAbrce/flj5bcel_addressx 

2.18.28.10 

fljpa_320x240_v 

/cig/othersrc/force/fl_pixel_addressx 

2.18.28.6 

f 1  _pa_640x240_h 

A:ig/othersrc/forc^j5ixel_addressx 

2.18.28.12 

fl_pa  640x240  v 

/cig/othersic^orce/fl_pixel_addressx 

2.18.28.8 

fl_pa_640x256_h 

/cig/otherstc^orce/fl_pixel_addressx 

2.18.28.11 

fl  _pa_640x256_v 

/cig/othersrc/force/fl_pixel_addressx 

2.18.28.7 

f  1  _pa_640x480_h 

/cig/othersrc/force/fl_pixel_addressx 

2.18.28.9 

fljpa_640x480_v 

/fcig/othersrc/forcft'fl_pixel_addressx 

2.18.28.5 

fl_pa_fb_offset 

/cig/othersic^<Mc^l_pixel_addressx 

2.18.28.4 

fl_pa_init 

/cig/othersrc^orce/fl_pKel_addressx 

2.18.28.1 

fl_pa_new_orientation 

/cig/othersrc/force/fl_pixel_addressx 

2.18.28.2 

fl_pa_new_resolution 

/cig/othersrc^orce/fl_pixel_addressx 

2.18.28.3 

fl_process_messages 

/cig/othersrc^orce/fl_pnxess_messagesx 

2.18.29 

fl_setup_environment 

/cig/othersrc/forc«^l  _setup_en  viroranentx 

2.18.30 

file_control 

/cig/libsrc/Iibrtt/file_control  x 

2.13.20 

fill_tree 

/cig/libsrc/libconfig/fill_treex 

2.5.4.1 

find_be_id 

/cig/libsrc/libvpt/be_stubsx 

2.17.1.2 

find_fh 

/cig/libsrc/libutil/nnd_glfnx 

2.16.4 

find_pitch_and_roll 

/cig/libsrc/libflea/flea_simulate_vehiclesx 

2.7.20.2 

FindField 

/cig/libsrdlibutil/find_fjeldx 

2.16.3 

fire_iound 

/cig/libsrc/libflea/encode.routinesx 

2.7.4.25 

flagoff 

/cig/libsrc/libvpt/flagoffx 

2.17.7 

flea 

/cig/libsrc/libnc^ea.c 

2.7.5.1 

flea_abs_playback 

/cig/libsrdliWlea/flea_scriptx 

2.7.19.1 

flea_agl_teiTain_follow 

/cig/libsrc/libflea/flea_agl_teiTain_followx 

2.7.6 

flea_agpt_locations 

/cig/libstx;/libflea^ea_agpl_locationsx 

2.7.7.1 

flea_agptJocations_main_menu 

/cig/libsrc/libflea/flea_agplJocationsx 

2.1.12 

flea_agpt_switches 

/cig/libsrc/Ubflea/flea_agpt_switchesx 

2.7.8.1 

flea_agpt_switches_main_menu 

/cig/libsr(^bflea/flea_agix_switchesx 

2.7.8.6 

flea_atp 

/cig/libsrcAibflea^ea.atpx 

2.7.9.1 

flea_atp_inain_incnu 

/cig/libsrc/libfiea/flea_aipx 

2.1.92 

flea_bi_opts 

/cig/Iibsrc/libflea/flea_bd_(Vtsx 

2.7.10.1 

nea_bal_opts_inain_menu 

/cig/libsrc/libnea/nea_bal_(^tsx 

2.7.10.2 

flea_calibration_iinage 

/cig/libsrc/libflea/nea_ppin_objx 

2.7.18.2 

flea_cleanup 

/cig/libsrc/libflea/neax 

2.7.5.11 

flea_db_traverse 

/cig/libsrc/libnea/nea_db_traversex 

2.7.11 
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flea_decode_data 

A:ig/libsrc/libflea/flea_decode_data.c 

2.7.12 

flea_demo 

/cig/libsrc/libflea/flea_denio.c 

2.7.13 

flea_draw_2d 

/cig/libsrcyiibflea/^ea_draw_2d.c 

2.7.14 

flea_dummy_getchar 

/cig/libsr(^bflea/flea.c 

2.7.5.4 

flea_encode_data 

/cig/libsrc/libflea/flea_encode_data.c 

2.7.15 

flea_enxM‘_print 

/cig/libsrc/libflea/encode_iDUtines.c 

2.7.4.22 

flea_getchar 

/cig/libsrc/libflea/flca.c 

2.7.5.3 

flea _graphics_test 

/cig/libsrc/libflea/Vlea _gr^^cs_test.c 

2.7.16.1 

flea_graphics_test_main_inenu 

/cig/libsrc/libfleaAlea _graphics_test.c 

2.7.16.2 

flea_host_if 

flea_init_cig_sw 

/cig/libsrc/libflea/flea_init_cig_sw.c 

2.7.17 

flea.initialized 

/cig/libsrc/liM]ea^ea.c 

2.7.5.8 

flea_IO_mode 

/cig/libsr(^bfleay^ea.c 

2.7.5.S 

flea_IO_off' 

/cig/1ibsrc/Iibflea/flea.c 

2.7.5.7 

flea_IO_on 

/cig/libsrc/libflea^ea.c 

2.7.5.6 

flea_io_task 

/cig/libsn^bflea^eax 

2.7.5.2 

flea_io_task_cleanup 

/cig/libsrc/libflea/flea.c 

2.7.5.12 

flea_n)m_display_mode 

/cig/libsrc/libflea/flea_ppm_obj  .c 

2.7.18.3 

flea_ppm_di^lay_offset 

/cig/libsrc/libflea/flea_ppm_obj  .c 

2.7.18.4 

flea_ppmj3ixel_location 

/cig/libsr<^bflea/flea_ppm_obj.c 

2.7.18.5 

flea_ppm_pixel_state 

/cig/libsrc/libflea/flea_ppm_obj.c 

2.7.18.6 

flea_printf 

/cig/libsrc/libflea/flea.c 

2.7.5.10 

flea_prompt 

/cig/libsrc/Iibflea/tick.c 

2.7.26.3 

flea_simul^_vehicles 

/cig/Ubsrc/libnea/flea_simulate_vehicles.c 

2.7.20.1 

flea_switches 

/cig/libsrc/Iibflea^ea_switches.c 

2.7.21.1 

flea_switches_fnain_inenu 

/cig/libsrc/libflea/flea_switches.c 

2.7.21.2 

flea_updatejx)s 

/cig/libsrc/libflea/flea_update_pos.c 

2.7.22 

flea_veh_contn)l 

/cig/libsrc/libflea/flea_veh_control.c 

2.7.23.1 

flea_veh_control_main_menu 

/cig/libsrc/libnea/flea_veh_control.c 

2.7.23.2 

ftoh 

/cig/libsrc/!ibgossip/dlp_einu.c 

2.9.4.6 

func_nisg  (config_database) 

/cig/libsic/libra/config_database.c 

2.13.12.3 

func_msg  (open_dbase) 

/cig/libsrcAil«^open_dbase.c 

2.13.36.2 

fxbvtofl 

/cig/libsrc/librtt/fxbvtofl  .c 

2.13.21.2 

fxbvu)fl_020 

/cig/libsrc/libro/fxbvtofl.c 

2.13.21.3 

fxbvtofl_dait 

/cig/libsrc/libm/fxbviofl.c 

2.13.21.1 

generic_Iin 

/cig/libsrc/librti/generic_lni.c 

2.13.22.2 

get_3d_lut_name 

/cig/libsrc/libtoken/subsys_cfg_parse.c 

2.15.2.6 

get_binary_data 

/cig/libsrc/libutil/sload.c 

2.16.5.5 

get_char 

/cig/libsrc/libutil/sload.c 

2.16.5.6 

get_colOT_config_name 

/cig/libsrc/libtoken/subsys_cfg_parse.c 

2.15.2.9 

get_ciinient_token 

/cig/libsrc/libtoken/lex.c 

2.15.1.8 

get_data_2d_nanie 

/cig/libsrc/libtoken/subsvs  cfg  parsex 

2.15.2.7 

get_database_naiT)e 

/cig/libsrc/libioken/subsvs  cfg  parsex 

2.15.2.3 

get_ded_name 

/cig/libsrc/libtoken/subsvs  cfg  parsex 

2.15.2.4 

get_d^_bank 

/cig/libsrc/lilwtt/sys_controlx 

2.13.46.6 

get_esifa_name 

/cig/libsrc/libtoken/subsvs  cfg  parsex 

2.15.2.8 

get_finaljut_name 

/cig/libsrc/libtoken/subsys_cfg_parsex 

2.15.2.5 

get_ln) 

/cig/libsrc/libgossip/dtp_cmux 

2.9.4.9 

get_msg_2d 

/cig/libsrc/lib2d/cig_getm_2dx 

2.2.4 

get_msg_2d  (offline  version) 

/cig/libsrc/lib2<j^_getin_2dx 

2.2.16 

get_next_niessage 

/cig/libsrc/libflea/flea_scriptx 

2.7.19.3 

get_next_packet 

/cig/libsiic/libflea/flea_scriptx 

2.7.19.2 

get_next_token 

/cig/libsrc/libtoken/lexx 

2.15.1.7 

get_number_value 

/cig/libsrc/libtoken/lexx 

2.15.1.9 

get_record 

/cig/libsrc/libutil/sloadx 

2.16.5.2 

get_sio_write_data 

/cig/libsrc/libflea/get_sio_datax 

2.7.24 

get_string_value 

/cig/libsrc/libtoken/lexx 

2.15.1.10 

get_thing 

/cig/libsrc/lib2d/get_thing  x 

2.2.8 
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get_tx_lut_index 

/cig/libsrc/librt!/get_tx_lut_index.c 

2.13.23 

get_vehicle_position 

/cig/libsrc/libconfig/get_vehicle_position.c 

2.5.5 

getch 

/cig/libsrc/libconng/getchx 

2.5.6 

GetFileName 

/cig/Iibsrc/libutil/directory.c 

2.16.2.4 

getlmdp 

/cig/Ubsic/librtt/k>ad_mo^es.c 

2.13.30.2 

getmatrix 

/cig/libsr(^ibrtt/inkintx_nt.c 

2.13.33.10 

getside 

/cig/libsic/libitt/k)ad_inodules.c 

2.13.30.3 

gos_120tx 

/cig/libsrc/Ubgossip/gos_120tx.c 

2.9.5 

gos_bal_quCTy 

/cig/libsrc/libgossip/gos_bal_queryx 

2.9.6 

gos.cigsimio 

/cig/libsrc/libra/cigsimio_objx 

2.13.7.1 

gos_db_quety 

/cig/libsrc/libgossip/gos_db_queryx 

2.9.7.1 

gos_db_query_menu 

/cigAibsrc/libgossip/gos_db_quCTyx 

2.9.7.3 

gos_display_db_info 

/cig/libsrc/libgossip/gos_db_queryx 

2.9.12 

gos_dummy_getchar 

/cig/Iibsrc/iibgossip/gossipx 

2.9.15.9 

gos_getchar 

/cig/Iibsrc/libgossip/gossipx 

2.9.15.8 

gos_IO_off 

/cig/libsrc/Ubgossip/gossipx 

2.9.15.11 

gos_IO_on 

/cig/Ubsrc/iibgossip/gossipx 

2.9.15.10 

gosjocate 

/cig/libsrc/Ubgossip/gosJocaiex 

2.9.8 

gos_main_menu 

/cig/libsic/iibgossip/gossipx 

2.9.15.7 

gos_memory 

/cig/libsrc/libgossip/gos_memoryx 

2.9.9 

gos_model 

/cig/libsrc/libgossip/gos_modelx 

2.9.10.1 

gos_inpv 

/cig/libsrc/libgossip/gos_mpvx 

2.9.11 

gos_nipvio 

/cig/libsrc/Iibgossip/gos_mpviox 

2.9.12 

gos_polys 

/cig/libsrc/libgossip/gosjx)lysx 

2.9.13 

gos_ppni_query 

/cig/libsrcAibbackend^pin_ci)jx 

2.3.10.5 

gos_ppm_query_menu 

/cig/libsrc/libbackend^pin_objx 

2.3.10.6 

gos_prompt 

/cig/libsrc/Iibgossip/gossipx 

2.9.15.6 

gos_singIe_step 

/cig/libsrc/libgossip/gossipx 

2.9.15.5 

gos_systcm 

/cig/libsrc/libgossip/gos_systemx 

2.9.14 

gos  timing  printout 

/cig/libsrc/libgossip/gossipx 

2.9.15.3 

gossip 

/cig/libsrc/libgossip/gossipx 

2.9.15.1 

gossip.cleanup 

/cig/libsrc/libgossip/gossipx 

2.9.15.12 

gossip_tick 

/cig/libsrc/libgossip/gossipx 

2.9.15.2 

gspjo 

/cig/othCTSic/force/gsp_iox 

2.18.33 

gsp_ioctl_read 

/cig/othersrc/force/force.asni 

2.18.31.4 

gsp_ioctI_write 

/cig/othersrc^wce/force.asm 

2.18.31.5 

gsp_read 

/cig/othersrc/forc^orce.asm 

2.18.31.3 

gsp_resei 

/cig/othersrc/forc^orce^m 

2.18.31.6 

gsp_write 

/cig/othersrc/forc^orce^m 

2.18.31.2 

hexdisplay 

/cig/libsrc/libgossip/dtp_emux 

2.9.4.5 

hosl_disable_all_debug_msgs 

/cig/libsrc/libhosl/hostJf_debugx 

2.10.4.3 

host_enable_alI_debug_tnsgs 

/cig/libsrc/libhosi/hosl_if_debugx 

2.10.4.2 

host_if_buffer_init 

/cig/libsrc/libitt/global_initx 

2.13.24.1 

host_if_debug 

/cig/libsrc/libhost/host_if_debugx 

2.10.4.13 

host_if_debug_init 

/cig/libsrQdibhost/host_if_debugx 

2.10.4.4 

host_if_debug_main_inenu 

/cig/libsrQdibhosl/host_if_debugx 

2.10.4.10 

host_if_debug_menu 

/cig/libsrc/libhost/host_if_debugx 

2.10.4.11 

host_if_debug_tick 

/cig/libsr(^bhosl/host_if_debugx 

2.10.4.12 

host_if_disable_debug_msgs 

/cig/libsr(^bhosl/host_if_debugx 

2.10.4.9 

host_if_display_enabled_insgs 

/cig/libsrc/Ubhosl/host_if_debugx 

2.10.4.6 

host_if_enable_debug_msgs 

/cig/libsrc/libhost/host_if_debugx 

2.10.4.8 

host_init_packet_sizes 

/cig/libsrc/Iibitt/global_iiiitx 

2.13.24.2 

host_list_msgs 

/cig/libsrc/libhost/lK)st_if_debugx 

2.10.4.7 

htof 

/cig/libsrc/libgossip/dip_emux 

2.9.4.7 

hw_test 

/cig/Iibsrc/librtt/hw_testx 

2.13.26 

hxfit 

/cig/libsrc/libgossip/dtp_emux 

2.9.4.4 

id_4x3nitx 

/cig/libsr<^ibitt/mkmlx_nix 

2.13.33.6 

id_matrix 

/cig/libsrc/librtl/make.bbnx 

2.13.32.6 
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init_drll_interface 

/cig/libsrcAibhostyhost_drl  l_if.c 

2.10.1.4 

init_dtp_stacks 

/cig/libsic/libgendtp/dq)_funcs.c 

2.8.2.4 

init_enet_interface 

/cig/libsrc/libhosl/host_enet_if.c 

2.10.2.5 

init_flea_interface 

/cig/libsrc/libhosiyhost_flea_if.c 

2.10.3.4 

init_generic_lm 

/cig/libsr(^ibrtt/genCTic_lm.c 

2.13.22.1 

init_mpv_interface 

/cig/libsrc/libhost/host_mpv_if.c 

2.10.5.4 

initjx)rts 

/cig/othersrc/forc^oice.asm 

2.18.31.1 

init_print_msg_array 

/cig/libsrc/libmsg/print_msg.c 

2.12.19.2 

init_scsi_interface 

/cig/libsrc/libhost/host_scsi_if.c 

2.10.6.4 

init.simulation 

/cig/libsrc/Iibrtt/init_sim  .c 

2.13.27 

init_socket_interface 

/cig/libsrc/libhost/host_socket_if.c 

2.10.7.4 

init_stuff 

/cig/libsrc/lib2d/init_stuff.c 

2.2.9 

init_subsys_parser 

/cig/libsrc/lilxoken/subsvs  cfg  parsec 

2.15.2.1 

initialize 

/cig/libsrc/librtt/rtt_init.c 

2.13.42.2 

initialize_defaiilts 

/cig/libsrc/librttMt_init.c 

2.13.42.1 

linkup 

/cig/libsrc/lib2d/cig_link_2d.c 

2.2.5 

linkup  (offline  version) 

/cig/libsrc/lib2dAi_link_2d.c 

2.2.17 

load_dbase 

/cig/libsrc/librtt^oad_dbase.c 

2.13.28 

load_esifa 

/cig/libsic/librtt/load_esifa.c 

2.13.29 

load_modules 

/cig/libstc/Iibru/load_modules.c 

2.13.30.1 

loc_ter_msg 

/cig/libsrc/libmsg/loc_ter_msg.c 

2.12.1 

local_teiTain 

/cig/libsrc/librtt/loc_ter.c 

2.13.31.1 

local_teiTain_cleanup 

/cig/libsrc/librtt/loc_ter.c 

2.13.31.2 

lt_state 

/cig/libsrc/libmsg/msg_lt_state.c 

2.12.9 

ml_gun_overlay 

/cig/libsrc/librtt/gun_overlays.c 

2.13.25.1 

m2_gun_overlay 

/cig/libsrc/libttt/gun_overlays.c 

2.13.25.2 

main  (ballistics) 

/cig/gtbinsrc/bxl47_main.c 

2.1. 1.1 

main  (force) 

/cig/othersic4'cHx:e/forcetask.c 

2.18.32.1 

main  (rtt) 

/cig/gtbinsrc/rtt/ittx 

2.1.3. 1 

main  (2-D  compiler) 

/cig/Iibsrc/lib2d/u_main_2d.c 

2.2.18 

make4x3 

/cig/libsrc/librtt/mkmtx_nt.c 

2.13.33.21 

make_bbn_logo 

/cig/libstc/libgossip/make_bbn_logo.c 

2.9.16 

niake_cal_matrices 

/cig/gtbinsrc/itl/mkcal.c 

2.1.2.2 

make_cal_overlay 

/cig/gtbinsrc/rtt/mkcal.c 

2.1.2.1 

make_cal_pattems 

/cig/gtbinsrcMt/mkcal.c 

2.1.2.3 

make_ml_overlays 

/cig/libsrc/librtt/gun_overlays.c 

2.13.25.3 

make_m2_overlays 

/cig/libsrc/librtt/gun_overlays.c 

2.13.25.4 

tnake_p_nt 

/cig/libsr<^ibrtt/mkmtx_nt.c 

2.13.33.1 

mat_adjugate 

/cig/libsrc/libitt/mkmtx_nt.c 

2.13.33.15 

mat_copy 

/cig/libsrc/librtl/mkmtx_nt.c 

2.13.33.13 

mat_determ  inant 

/cig/libsrc/librtl/mkmtx_nt.c 

2.13.33.18 

mat_inverse 

/cig/libsrc/librtt/mkmtx_nt.c 

2.13.33.19 

mat_mult 

/cig/libsrc/libgossip/dtp_emu.c 

2.9.4.8 

mat_scale 

/cig/libsrc/librtt/mkmtx_nt.c 

2.13.33.17 

mat_transpose 

/cig/Iibsrc/librtt/mkmtx_nt.c 

2.13.33.16 

mat_vec_mul 

/cig/libsrc/librtt/mkmtx_nt.c 

2.13.33.14 

matnx2 

/cig/libsrc/librtl/mkmu_nt.c 

2.13.33.11 

mem_check 

/cig/libsrc/libvpt/tst_tree.c 

2.17.22.2 

menu_header 

/cig/libsic/libflea/tick.c 

2.7.26.5 

model_demo 

/cig/libsrcAibflea/model_demo.c 

2.7.25 

model_mU 

/cig/libsrc/librtt/model_mtx.c 

2.13.34 

mpvideo_boot 

/cig/libsrc/libmpvideo/bootmpv.c 

2.11.2.1 

mpvideo_define_mode 

/cig/libsrc/libmpvideo/mpvidM_mode.c 

2.11.7.2 

mpvideo_get_object_addr 

/cig/libsrc/libmpvideo/mpvideo_man.c 

2.11.6.6 

mpvideo_laser_iequest_range 

/cig/libsrc/libmpvideo/mpvideo_laser.c 

2.11.4 

mpvideojoad 

/cig/libsrc/libmpvideo/loadmpv.c 

2.11.3 

mpvideo_num_paths 

/cig/libsrc/libmpvideo/mpvideo_query.c 

2.11.11 

• 

mpvideo_pass_back 

/cig/libsrc/libmpvideo/mpvideo_pass_back.c 

2.11.8 
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mpvideo_pass_on 

/cig/libsrc/Iibmpvideo/mpvideo_pass_on.c 

2.11.9 

mpvideo.response 

/cig/libsrcAibmpvideoAnpvideo_response.c 

2.11.12 

mpvideo_seiid_req 

/cig/libsrc/libmpvideo/mpvideo_man.c 

2.11.6.5 

mpvideo_seUut 

/cig/libsrc/libmpvideo/mpvideo_lut.c 

2.11.5 

mpvideo_set_mode 

/cig/libsrc/libmpvideo/mpvideo_mode.c 

2.11.7.1 

mpvideo_set_video 

/cig/libsrc/libmpvideo/mpvideo_man.c 

2.11.6.1 

mpvidco_setup 

/cig/libsrc/libmpvideo/mpvideo_man.c 

2.11.6.2 

mpvideo_siin_init 

/cig/libsrc/libmpvideo/mpvideo_man.c 

2.11.6.4 

mpvideo_stop 

/cig/Iibsrc/libmpvideo/mpvideo_man.c 

2.11.6.3 

tnpvmsg_froin_buf_addr 

/cig/libsrc/libmpvideo/b(^orce.c 

2.11.1.7 

mpvinsg_quCTy_buf_addr 

/cig/libsrc/Ubmpvideo/bootforce.c 

2.11.1.4 

mpvinsg_reply_buf_addr 

/cig/libsrc/Ubmpvideo/bootforce.c 

2.11.1.5 

mpvmsg_to_buf_addr 

/cig/Iibsrc/Iibmpvideo/bootforce.c 

2.11.1.6 

insg_lrotation 

/cig/libsrc/libmsg/msg_vport.c 

2.12.18.8 

msg_3rotations 

/cig/libsrc/libmsg/msg_vport.c 

2.12.18.9 

msg_calibration_iinage 

/cig/libsrc/libmsg/msg_calibration_image.c 

2.12.2 

msg_cig_ctl 

/cig/libsr<^ibmsg/msg_cig_ctl.c 

2.12.3 

msg_drl  l_iSct_size 

/cig/libsrc/libmsg/msg_dr  1 1  .c 

2.12.4 

msg_end 

/cig/libsrc/libmsgAnsg_end.c 

2.12.6.1 

msg_hprxyzs_matrix 

/cig/libsrc/libmsg/msg_vport.c 

2.12.18.5 

msg_Iaser_reqiiest_iange 

/cig/libsrc/Iibmsg/msg_laser.c 

2.12./ 

insg_laser_fetum 

/cig/libsrc/libmsg/msg_lascr_retuni.c 

2.12.8 

msg_otherveh_state 

/cig/libsr(^ibmsg/msg_veh_state.c 

2.12.16.1 

msg_pass_back 

/cig/libsrcAibmsg/msg_pass_back.c 

2.12.10 

msg  pass  on 

/cig/bbsr(^ibmsg/msg_pass_on.c 

2.12.11 

msg  ppm  display  mode 

/cig/libsrc/libmsg/msg_ppm.c 

2.12.12.1 

msg  ppm  display  offset 

/cig/libsrc/libmsg/msg_ppm.c 

2.12.12.2 

msg  ppm  pixel  location 

/cig/libsrc/Ijbmsg/msg_ppm  .c 

2.12.12.3 

msg  ppm  pixel  state 

/cig/libsrc/libmsg/msg_ppm.c 

2.12.12.4 

msg_piocess_found48 

/cig/libsrc/libmsg/msg  process  round48.c 

2.12.13 

msg_rot2xl_matrix 

/cig/libsrc/libmsg/msg_vport.c 

2.12.18.3 

msg_ils4x3_matrix 

/cig/libsrc/libmsg/msg_vport.c 

2.12.18.4 

msg_scale 

/cig/libsrc/libmsg/msg_vport.c 

2.12.18.7 

msg_shell_sort 

/cig/libsrc/libhost/host_if_debug.c 

2.10.4.1 

msg_show_effect 

/cig/libsrc/libmsg/msg_effecLc 

2.12.5 

msg_staticveh_rem 

/cig/libsrc/libmsg/msg_veh_state.c 

2.12.16.3 

msg_staticvch_state 

/cig/libsrc/libmsg/msg_veh_state.c 

2.12.16.2 

msg_subsys_mode 

/cig/libsrc/libmsgAnsg_subsys_mode.c 

2.12.14 

msg_syseiT 

/cig/libsrc/Iibmsg/msg_syserr.c 

2.12.15 

msg_translation 

/cig/libsrc/libmsg/msg_vport.c 

2.12.18.6 

msg_view_flags 

/cig/libsrc/libmsg/msg_vnags.c 

2.12.17 

msg_view_magnification 

/cig/libsrc/libmsg/msg_vport.c 

2.12.18.2 

msg_viewport_update 

/cig/libsrc/Iibmsg/msg_vport.c 

2.12.18.1 

mtx_non_perspective 

/cig/libsrc/libvp»/mtx_viewspace.c 

2.17.13.1 

mtx_perspective 

/cig/libsrc/libvpt/mlx_viewspace.c 

2.17.13.2 

mtxcpy 

/cig/libsrc/libra/mkmtx_nt.c 

2.13.33.12 

mult_4x3mtx 

/cig/libsrc/librU/mkmtx_nt.c 

2.13.33.9 

multmatrix 

/cig/libsrc/librU/make_bbn.c 

2.13.32.5 

mx2_error  (force) 

/cig/othersrc/force/mx2_hword.c 

2.13.34.5 

mx2_OTor  (rtsw) 

/cig/libsre/lil»it/mx2_hword.c 

2.13.35.5 

mx2_hwcopy  (force) 

/cig/othersrc^orce/mx2_hword.c 

2.13.34.6 

mx2_hwa^y  (rtsw) 

/cig/libsrc/libru/mx2_hword.c 

2.13.35.6 

mx2_open  (force) 

/cig/othCTsrc^<wce/mx2_hword.c 

2.13.3^.! 

mx2_open  (rtsw) 

/cig/libsrc/librtt/mx2_hword.c 

2.13.35.1 

mx2_peek  (fOTce) 

/cig/othersrcAbrce/mx2_hword.c 

2.13.34.3 

mx2_peek  (rtsw) 

/cig/libsrc/librtt/mx2_hword.c 

2.13.35.3 

mx2_piish  (force) 

/cig/othersrc^orce/mx2_hword.c 

2.13.34.2 

mx2_push  (rtsw) 

/cig/libsrc/librtl/mx2_hword.c 

2.13.35.2 
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inx2_skip  (force) 

/cig/othersrc/force/mx2_hword.c 

2.13.34.4 

mx2_skip  (rtsw) 

/cig/libsrc/librtt/mx2_hword.c 

2.13.35.4 

mx3_error 

/cig/libsrc/libgossip/mx3_hword.c 

2.9.17.5 

inx3_hwcopy 

/cig/bbsrc/libgossip/inx3_hword.c 

2.9.17.6 

mx3_open 

/cig/libsn71ibgossip/mx3_hword.c 

2.9.17.1 

inx3_peek 

/cig/libsrQTibgossip(inx3_hword.c 

2.9.17.3 

mx3_push 

/cig/libsrc/libgossip/mx3_hword.c 

2.9.17.2 

mx3_skip 

/cig/libsrc/libgossip/inx3_hword.c 

2.9.17.4 

mxjenor 

/cig/libsrc/libballAnx_eiTor.c 

2.4.4.1 

inx_open 

/cig/libsnvlibball/nix_open.c 

2.4.4.2 

mx_p^ 

/cig/libsrc/libball/mx_peek.c 

2.4.4.3 

mx_push 

/cig/libsrc^ibball/mx_push.c 

2.4.4.4 

mx_skip 

/cig/libsrc/libball/mx_skip.c 

2.4.4.5 

mx_wcopy 

/cig/libsrc/libball^ix_wcopy.c 

2.4.4.6 

new_pos_orient 

/cig/libsrc/libfleajflea_agpt_locations.c 

2.7.7.3 

next_char 

/cig/libsrc/Ubti(Aen/lex.c 

2.15.1.2 

next_line 

/cig/libsrq4ibtoken/lex.c 

2.15.1.5 

next_token 

/cig/libs«^btoken/lex.c 

2.15.1.4 

nmi_type 

/cig/othersrc/fotce/nmi_type.c 

2.13.35 

old_mtx_perspective 

/cig/libsrc/libvpt/mtx_viewspace.c 

2.17.13.3 

q)en_dbase 

/cig/libsrc/libru/opcn_dbase.c 

2.13.36.1 

open_ued 

/cig/libsrc/librtt/open_ded.c 

2.13.37 

open_drl  l_interface 

/cig/libsrc/libhost)host_drl  l_if.c 

2.10.1.1 

q)en_enet_interface 

/cig/libsrc/libhosl/host_enet_if.c 

2.10.2.1 

c^n_flea_interface 

/cig/libsrc/libhosl/host_nea_if.c 

2.10.3.1 

open_mpv_interface 

/cig/libsrc/libhost/host_mpv_if.c 

2.10.5.1 

open_scsi_interface 

/cig/libsrc/libhost/host_scsi_if.c 

2.10.6.1 

open_socket_interface 

/cig/libsrc/libhosti1iost_socket_if.c 

2.10.7.1 

OpenDir 

/cig/libsrc/libutil/directory.c 

2.16.2.1 

otherveh_state 

/cig/libsrc/lilwtt/otherveh_state.c 

2.13.38 

outahere 

/cig/libsrc/libgossip/replace_inod.c 

2.9.18.6 

outdisplay 

/cig/libsrc/libgossip/dtp_emu.c 

2.9.4.3 

overlay_setup 

/cig/libsrc/libconfig/overlay_setup.c 

2.5.7 

p_configtree_node 

/cig/libsni4ibvpt/tst_ereadconfig.c 

2.17.20.2 

p_overlay_setiip 

/cig/libsrc/libvptAst_CTeadconfig.c 

2.17.20.4 

p_temain_feedback 

/cig/libsrc^bvptAsl_ereadconfig.c 

2.17.20.6 

p_viewpoit_state 

/cig/libsrc/libvptAst_ereadconfig.c 

2.17.20.3 

parse_subsys_file 

/cig/libsrc/libt^en/subsys_cfg_parsc.c 

2.15.2.2 

pix_mult 

/cig/gtbinsrcMt/mkcal  .c 

2.1.2.4 

poll_ready 

/cig/othersrcyforce^ll_ieady.c 

2.13.36 

poU_shutdown  (ballistics) 

/cig/gtbinsrc/bx  147_inain.c 

2.1. 1.2 

poll_shutdown  (rtt) 

/cig/gtbinsrc/rtl/i1I.c 

2. 1.3.5 

pool_get_off_24 

/cig/libsrc/librtt/ded_gmjxx)l.c 

2.13.15.2 

pool_init 

/cig/libsrc/librtt/ded_gtnjxx)l.c 

2.13.15.1 

pop_node 

/cig/libsrc/libgendtp/dtp_funcs.c 

2.8.2.2 

power 

/cig/libsrc/libconfig/fi!l_tree.c 

2.5.4.2 

ppm_get_data 

/cig/libsrc/libbackend^tn_obj.c 

2.3.10.3 

ppin_init 

/cig/libsrc/libbackend^pin_obj.c 

2.3.10.2 

ppm.load 

/cig/libsrc/libbackend4>pin_obj.c 

2.3.10.4 

I^in_setup 

/cig/libsrc/libbackend4>pni_obj  .c 

2.3.10.1 

pr_branch 

/cig/libsrc/libvpt/tst_treetrace.c 

2.17.23.2 

pr_inaoix 

/cig/libsrc/Iibvp^(tst_treetracc.c 

2.17.23.3 

pretend.veh 

/cig/libsrcAibrtt4>retend_veh.c 

2.13.39 

print_m  sg_  1  rotation 

/cig/libsrc/libmsg/print_insg.c 

2.12.19.1 

print_msg_2d_setup 

/cig/libsrc/libmsg^rint_msg.c 

2.12.19.1 

print_msg_3rotations 

/cig/libsrc/libmsg/prinl_insg.c 

2.12.19.1 

paTnt_nisg_add_traj_table 

/cig/libsrc/libmsg/print_msg.c 

2.12.19.1 

print_msg_agl 

/cig/libsrc/libmsg^rint_msg.c 

2.12.19.1 
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print_msg_agl_setup 

/cig/libsrc/libmsg/print_msg.c 

2.12.19.1 

print_msg_ammo_define 

/cig/libsrc/libmsg^rint_nisg.c 

2.12.19.1 

print_msg_calibration_image 

/cig/libsrc/libmsg^rini_msg.c 

2.12.19.1 

print_msg_cancel_round 

/cig/libsrc/libmsg^rint_msg.c 

2.12.19.1 

print_msg_cig_ctl 

/cig/libsic/libmsg^rint_msg.c 

2.12.19.1 

piint_msg_cloud_state 

/cig/libsrc/Iibmsg^rint_msg.c 

2.12.19.1 

print_msg_create_confignode 

/cig/libsrc/libmsg^rint_msg.c 

2.12.19.1 

print_msg_default 

/cig/libsrc/libmsg4>rint_insg.c 

2.12.19.1 

print_msg_defiiie_ix_mode 

/cig/Iibsrc/libinsg4)rint_nisg.c 

2.12.19.1 

print_msg_delete_traj_table 

/cig/libsrc/libnisg^rint_insg.c 

2.12.19.1 

print_msg_drl  l_pkt_size 

/cig/libsrc/libmsg^rint_msg.c 

2.12.19.1 

print_msg_end 

/cig/libsrc/Iibmsg^rint_msg.c 

2.12.19.1 

print_msg_file_descr 

/cigAibsrc/libmsg^rint.msg.c 

2.12.19.1 

print_msg_file_status 

/cig/libsrc/libmsg^rint_insg.c 

2.12.19.1 

print_msg_file_xfer 

/cig/libsic/libmsg^rint_msg.c 

2.12.19.1 

print  msg  pin  overlay 

/cig/libsrc/libmsgi^rint_msg.c 

2.12.19.1 

print_msg_hit_retuni 

/cig/libsfc/libmsg^rint_insg.c 

2.12.19.1 

print_msg_hit_retum48 

/cig/libsrc/libmsg4>rint_msg.c 

2.12.19.1 

print_msg_hprxyzs_matrix 

/cig/libsrc/libnisg/print_msg.c 

2.12.19.1 

print_msg_laser_retum 

/cig/libsrc/libmsg^rint_msg.c 

2.12.19.1 

print_msg_local_teiTain 

/cig/libsrcAibinsg/print_nisg.c 

2.12.19.1 

print_msg_lt_piece 

/cig/libsrc/libmsg^rint_insg.c 

2.12.19.1 

print_msg_lt_state 

/cig/libsrc/libmsg/print_n)sg.c 

2.12.19.1 

print_msg_niiss 

/cig/libsrc/libinsg^rint_insg.c 

2.12.19.1 

print_nisg_obscure 

/cig/libsrc/libmsg^rint_msg.c 

2.12.19.1 

print_msg_otherveh_state 

/cig/libsrc/Ubmsg/print_msg.c 

2.12.19.1 

print_nisg_overIay_setup 

/cig/libsrc/libmsg/print_msg.c 

2.12.19.1 

print  msg  pass  back 

/cig/libsrc/libmsg^rint_msg.c 

2.12.19.1 

print_msg_pass_on 

/cig/libsrc/libmsg^rint_insg.c 

2.12.19.1 

print_n.  _pom_<lisplay_mode 

/cig/libsrcflibmsg/printjmsg.c 

2.12.19.1 

print  msg  ppm  display  offset 

/cig/libsrc/libmsg/print_msg.c 

2.12.19.1 

print  msfg  ppm  pixel  location 

/cig/libsrc/libnisg/print_msg.c 

2.12.19.1 

print  msg  ppm  pixel  state 

/cig/libsrc/libmsg/print_msg.c 

2.12.19.1 

print  msg  process  chord 

/cig/libsrc/libmsg^rint_nisg.c 

2.12.19.1 

print  msg  process  round 

/cig/libsrc/libnisg/print_insg.c 

2.12.19.1 

print  msg  process  round48 

/cig/libsrc/libmsg^rint_msg.c 

2.12.19.1 

print_nisg_request_laser_range 

/cig/libsrc/libmsgi^rint_msg.c 

2.12.19.1 

print_insg_request_point_info 

/cig/libsrc/libmsg/print_msg.c 

2.12.19.1 

print_insg_retum_point_info 

/cig/libsrc/!ibnisg^rint_insg.c 

2.12.19.1 

print_tnsg_rot2x  l_niatrix 

/cig/libsrc/libmsg4)rint_ni5g.c 

2.12.19.1 

print_insg_round_fired 

/cig/libsrc/libmsg^rint_msg.c 

2.12.19.1 

prinl_msg_its4x3_niatrix 

/cig/libsrc/libmsg/print_msg.c 

2.12.19.1 

print_insg_scale 

/cig/libsrc/libinsg4)rint_msg.c 

2.12.19.1 

print_nisg_shot_report 

/cig/libsrc/Ubmsg,^rint_msg.c 

2.12.19.1 

print_msg_shot_rqx)rt48 

/cig/libsrc/libmsg4>rint_msg.c 

2.12.19.1 

print_insg_show_effect 

/cig/libsrc/!ibmsg^nt_msg.c 

2.12.19.1 

IMinl_nisg_sio_close 

/cig/libsrc/libmsg^rint_nisg.c 

2.12.19.1 

print_msg_sio_init 

/cig/Iibsrc/Iibmsg^rint_msg.c 

2.12.19.1 

print_msg_sio_write 

/cig/libsrc/libmsg^rint_msg.c 

2.12.19.1 

prinl_msg_staticveh_rein 

/cig/libsrc/libmsg^rint_msg.c 

2.12.19.1 

|MTnt_nisg_staticveh_state 

/ci^ibsrc/libmsg/print.msg.c 

2.12.19.1 

print_msg_subsys_niode 

/cig/libsic/libinsg^nt_nisg.c 

2.12.19.1 

print_insg_sys_error 

/cig/libsrc/Iibmsg^nt_msg.c 

2.12.19.1 

prinl_msg_test_nanie 

/cig/libsrc/Iibmsg4)rint_msg.c 

2.12.19.1 

print_insg_tf_hdr 

/cig/libsrc/Iibnisg4)rint_insg.c 

2.12.19.1 

print_msg_tf_init_hdr 

/cig/libsrc/libmsg/print_msg.c 

2.12.19.1 

print_msg_tf_init_pt 

/cig/libsrc/Iibmsg/print_msg.c 

2.12.19.1 

print_msg_tf_pt 

/cig/libsrc/libmsg/print_msg.c 

2.12.19.1 
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print_nisg_tf_pt48 

print_msg_tf_state 

print_msg_tf_vehicle_pos 

print_nisg_traj_chOTd 

print_msg_traj_entry 

print_msg_traj_entry_xfer 

print_insg_traj_table_xfer 

print_msg_tfanslation 

print_msg_view_flags 

print_msg_view_niagnification 

print_msg_viewport_staie 

print_insg_viewport_iqxlaie 

print_pdbase 

IHXKess_2d_setup 

pnx»ss_a_iTisg 

process_add_tiaj_table 

process_agLsetup 

process_am/no_define 

process_chord 

process_cig_ctl 

IHOcess_coinmand 

ITOcess_configtree_node 

piocess_define_tx_mode 

process_drl  l_pkt_size 

process_file_description 

process_lt_state 

ptocess_overiay_setup 

process_ppm_display_mode 

piiocess_ppin_display_offset 

pnx:ess_ppin_pixelJocatjon 

process_ppm  _pixeLstate 

process_round 

pnx»ss_sio_close 

process_sio_init 

process_tf_init_hdr 

process_lf_init_pt 

pnK«ss_tf_state 

pnx«ss_traj_entry 

process_vflags 

process_viewport_state 

process_vppos 

prt_intx 

prtackerr 

pitmsgerr 

prtstaterr 

push_node 

put_in_hdr 

r4mat_dump 

r8inat_dump 

rcl_command 

rcl_cotnponent 

icLdata 

rcljnit_adrs 

rcl_init_stack 

rcljblcmd 

rcl_patch_adrs 

rcljx)p 

rcLpush 


Location 

Section 

/cig/libsrc/libmsg^rint_msg.c 

2.12.19.1 

/cig/libsrc/libmsg/print_msg.c 

2.12.19.1 

/cig/libsrc/libmsg/print_msg.c 

2.12.19.1 

/cig/libsrc/libmsg/print_insg.c 

2.12.19.1 

/cig/libsrc/libmsg^rint_msg.c 

2.12.19.1 

/cig/libsrc/libinsg/^rim_msg.c 

2.12.19.1 

/cig/libsrc/libmsg^rint_msg.c 

2.12.19.1 

/cigAibsrc/libmsg4>rint_msg.c 

2.12.19.1 

/cig/libsrc/libinsg^nt_msg.c 

2.12.19.1 

/cig/libsrc/libinsg^rint_msg.c 

2.12.19.1 

/cig/libsrc/libmsg^rint_msg.c 

2.12.19.1 

/cig/libsrc/libmsg^nt_insg.c 

2.12.19.1 

/cig/libsrc/libitt/coniig_database.c 

2.13.12.4 

/cig/libsrc/libnea/cf_lranslat(v.c 

2.7.2.14 

/cig/libsrc/librtl/simulation.c 

2.13.43.2 

/cig/libsrc/Iibflea/cf_tTanslatOT.c 

2.7.2.12 

/cig/Iibsrc/libflea/cf_lranslator.c 

2.7.2.10 

/cig/libsrc/libflea/cf_translator.c 

2.7.2.19 

/cig/libsrc/libnea/encode_ioutines.c 

2.7.4.26 

/cig/Iibsrc/libflea/cLtranslatOT.c 

1.12.2 

/cig/libsr<^b2d/proc_cmd.c 

i.i.n 

/cig/libsrc/libfle^cf_translatOT.c 

2.1.2.4 

/cig/libsrc/libnea/cf_translator.c 

2.1.2.6 

/cig/libsrc/libflea/cf_lranslator,c 

2.7.2.16 

/cig/libsrc/libnca/cf_lranslator.c 

l.l.l.-i 

/cig/libsrc/Iibflea/cf_translator.c 

2.7.2.15 

/cig/libsrc/libflea/cf_translat(»-.c 

22.2.1 

/cig/libsrc/libflea/cf_translator.c 

2.7.2.20 

/cig/libsrc/libnea/cf_translaux-.c 

2.7.2.21 

/cig/libsrc/libflea/cf_translator.c 

2.7.2.22 

/cigAibsrc^ibflea/cLtranslator.c 

2.7.2.23 

/cig/Ubsrc/libnea/encode_routines.c 

2.7.4.27 

/cig/Ubsrc/libflea/cf_transIalor.c 

2.7.2.17 

/cig/libsrc/libflea/cf_translator.c 

2.7.2.11 

/cig/libsic/libflea/cf_tTanslator.c 

2.1.2.% 

/cig/libsK^ibflea/cf_translator.c 

2.1.22 

/cig7ibsrc/libflea/cf_transIator.c 

2.7.2.18 

/cig/libsrc/libflea/cf_translator.c 

2.7.2.13 

/cig/libsrc/Iibconrig/process_vflags.c 

2.5.8 

/cig/libsrc/Iibnea/cf_transIator.c 

2.1.2.5 

/cig/Iibsrc/libconfig/process_vppos.c 

2.5.9 

/cig/libsrc/bbftl/inake_bbn.c 

2.13.32.1 

/cig/libsrc/libmpvideo/bootmpv.c 

2.11.2.3 

/cig/libsrc/Iibmpvide(Vbootmpv.c 

2.11.2.2 

/cig/libsrc/libmpvideo/bootmpv.c 

2.11.2.4 

/cig/libsrc/libgCTdtp/dtp_funcs.c 

2.8.2.1 

/cig/libsrc/libflea/enccxle_routines.c 

2.7.4.23 

/cig/Iibsrc/libvpi/mtx_dump.c 

2.17.12.1 

/cig/libsrc/libvpi/nitx_dump.c 

2.1''. 12.2 

/cig/libsrc/UbgendipAcfuiics.c 

2.8.5.11 

/cig/libsrc/bbgcndtpAcfuncs.c 

2.8.5.12 

/cig/libsrc/libgendli^rcfuncs.c 

2.8.5.13 

/cig/Ubsic/lil^endtp/rcfuncs.c 

2.8.5.6 

/cig/libsic/Iibgendtp/rcfuncs.c 

2.8.5.1 

/cig/libsrc/libgendip/rcfuncs.c 

2.8.5.10 

/cig/libsrc/libgendip/icfuncs.c 

2.8.5.4 

/cig/libsic/lil^endtiVrcfuncs.c 

2.8.5.3 

/cig/libsrc/libgendtp/rcfuncs.c 

2.8.5.2 
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rcl_iln_adrs 

/cig/libsrc/libgendtp/rcfiincs.c 

2.8.5.7 

rcl_set_cntlbl 

/cig/libsic/UbgendtiVrcfuncs.c 

2.8.5.9 

rcl_set_enptr 

/cig/libsic/libgendtiVicfuncs.c 

2.8.5.5 

rcl_set_label 

/cig/libsic/Ubgendtp/icfuncs.c 

2.8.5.8 

rcl_set_inodloc 

/cig/libsic/libgossip/gos_inodel.c 

2.9.10.2 

rcl_stuff_data 

/cig/libsic/libgend^rcfuncs.c 

2.8.5.14 

read_a_keyword 

/cig/libsrc/libflea/cf_translatCH'.c 

2.7.2.24 

read_cvc_control 

/cig/Iibsrc/libnt/sys_control.c 

2.13.46.7 

ReadDir 

/cig/libsnvlibutil/directory.c 

2.16.2.2 

redjclcKk 

/cig/othersic/fQrce/forcetask.c 

2.18.32.4 

reinove_comment_lines 

/cig/libsrc/libfIea/cf_translator.c 

2.7.2.26 

remove_white_space 

/cig/libsrc/libfIea/cf_translator.c 

2.7.2.25 

rq)lace_mod 

/cig/libsrc/libgossip/replace_mod.c 

2.9.18.1 

restaitjclock 

/cig/otheisic/fQfce/fQrcetask.c 

2.18.32.3 

restore_cur 

/cig/libsrc/Iibutil/vtlOO.c 

2.16.7.8 

retum_aain _ptr 

/cig/libsrc/libconrig/aain_inanager.c 

2.5.1.2 

md 

/cig/Iibsrc^brtt/cloud$.c 

2.13.9.8 

rotate_x 

/cig/libsrc/librtl/make_bbn.c 

2.13.32.2 

rotate_x_m 

/cig/libsrc^ibrtt/mkmtx_nt.c 

2.13.33.2 

rotate_y 

/cig/libsrc/iibrn/make_bbn.c 

2.13.32.3 

rotate_y_nt 

/cig/libsr<^ibru/mkinu_nt.c 

2.13.33.3 

rotate_z 

/cig/libsrc/librtt/make_bbn.c 

2.13.32.4 

rotate_z_nt 

/cig/libsrc/Iibrtl/mkmtx_ni.c 

2.13.33.4 

TDwcol_rd_l 

/cig/libsrc/librttAowcoLrd.c 

2.13.40.1 

rowcol_rd_l_cleanup 

/cig/libsrc/libftt/iowcoLrd.c 

2.13.40.6 

rowcol_rd_2 

/cig/libsrc^bftl/rowcol_rd.c 

2.13.40.2 

rowcol_rd_2_cleanup 

/cig/libsrc/librn/iDwcol_rd.c 

2.13.40.7 

rowcoLrd_3 

/cig/libsrc/librtt/rowcol_rd.c 

2.13.40.3 

rowcoI_rd_3_cleanup 

/cig/libsrc/librtt/rDwcol_rd.c 

2.13.40.8 

rowcoLrd_4 

/cig/libsrc/librtt/rowcoLrd.c 

2.13.40.4 

rowcol_rd_4_cleanup 

/cig/libsrc/libftl/iowcol_rd.c 

2.13.40.9 

rt_accept 

/cig/libsrc/librtt/rt_mailbox.c 

2.13.41.3 

rt_pend 

/cig/libsrc/librtl/rt_niailbox.c 

2.13.41.1 

rt_post 

/cig/libsrc/librtt/it_niailbox  .c 

2.13.41.2 

rtn_entry_pt 

/cig/libsrc/libtnpvideo/bootforce.c 

2.11.1.3 

rtt_shuttown 

/cig/gtbinsrcAtl/ru.c 

2.1.3.4 

s_step 

/cig/libsrc/libgossip/gossip.c 

2.9.15.4 

save_cur 

/cig/libsrc/Iibutil/vt  1  OO.c 

2.16.7.7 

scale.mtx 

/cig/libsrc/librtl/mkmu_nt.c 

2.13.33.7 

scan_number 

/cig/libsrc/Iibioken/lex  .c 

2.15.1.3 

scraich_flea 

/cig/libsrc/libnea/nea.c 

2.7.5.9 

scroll_reg 

/cig/libsrc/libuti!/vtl(X).c 

2.16.7.9 

se_clock 

/cig/otherac/fotc^circetask.c 

2.18.32.5 

send_ammo_define 

/cig/Iibsrc/libf!ea/encode_routines.c 

2.7.4.32 

send_data 

/cig/libsrc/Iibutil/sload.c 

2.16.5.3 

send _gun_ovalay 

/cig/libsrc/libflea/encode.ioutines.c 

2.7.4.31 

set_3d_lut_naine 

/cig/Iibsrc^btoken/subsys_cfg_parse.c 

2.15.2.13 

set_color_config:_nan[ie 

/cig/Iibsrc/libK^en/subsvs  cfg  parsc.c 

2.15.2.15 

set_conimand_2d 

/cig/Ubsrc/libnea/nea_agpt_switches.c 

2.7.8.2 

set_data_2d_naiTje 

/cig/Iibsrc/libtoken/subsys_cfg_parse.c 

2.15.2.14 

set_daabase_name 

/cig/libsrc/libtc^en/subsvs  cfg  parsc.c 

2.15.2.10 

set_ded_name 

/cig/libsrc/libt£*en/subsys_cfg_parse.c 

2.15.2.11 

set_entry_pt 

/cig/libsrc/libmpvideo/bootforce.c 

2.11.1.2 

set_esifa_name 

/cig/libsrc/libtoken/subsys_cfg_parse.c 

2.15.2.15 

set_final_lut_name 

/cig/libsrc/libloken/subsys_cfg_parse.c 

2.15.2.12 

set_leds 

/cig/libsrc/IibiH/sys_conirol.c 

2.13.46.3 

setjut 

/cig/libsrc/libill/ciouds.c 

2.13.9.7 

set_token_rile 

/cig/libsrc/libioken/lex.c 

2.15.1.1 
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sctup_bit_blt 

/cig/libsrc/lib2d^it_blt.c 

2.2.1 

setup_coinp_start 

/cig/libsrc/lib2d/comp.c 

2.2.6 

setup_define_string 

/cig/libsrc/lib2d/string.c 

2.2.13 

setup_define_window 

/cig/Ubsrc/lib2d/window.c 

2.2.19 

setup_draw_line 

/cig/Ubsrc/lib2d/drawJine.c 

2.2.7 

setup_oval_rectangle 

/cig/Ubsrc/lib2d/oval_recLc 

2.2.10 

setup_p_tOTain_feedback 

/cig/Ubsrc/libvpiAst_ereadconfig.c 

2.17.20.5 

setup_poly 

/cig/libsrc/lib2d^ly.c 

2.2.11 

setup_iext 

/cig/libsrc/lib2d/textc 

2.2.14 

sgr 

/c  ig/libsrc/libutil/vt  1  OO.c 

2.16.7.2 

shot_report 

/cig/libsrc/libbalVshot_reportc 

2.4.3.12 

show_effect_msg 

/cig/libsic/libmsg/show_effect_msg.c 

2.12.20 

sim_bal_agl_wanied 

/cigAibsrc/librtt/bal_routines.c 

2.13.4.5 

siin_bal_ftame_rate 

/cig/libsrc/librtt/bal_routincs.c 

2.13.4.3 

siin_bal_init 

/cig/libsrc/librtt/bal_routines.c 

2.13.4.1 

siin_bal_process_insg 

/cig/libsrc/librtl/bal_routines.c 

2.13.4.6 

sim_bal_process_tracer 

/cig/libsrc/librtt/bal_routines.c 

2.13.4.7 

/cig/libsrc/librtt/bal_routines.c 

2.13.4.4 

sim_bal_reset 

/cig/libsrc/librttA»al_routines.c 

2.13.4.12 

siin_bal_round_fired 

/cig/libsrc/librtj/ba]_routines.c 

2.13.4.9 

sim_bal_start 

/cig/libsrc/librtt/bal_routines.c 

2.13.4.2 

siin_bal_stauc_add 

/cig/libsrc/librti/bal_routines.c 

2.13.4.10 

sim_bal_static_rem 

/cig/libsrc/librti/bal_routines.c 

2.13.4.11 

siin_bal_tf_veh_update 

/cig/libsrc/librtt/bal_rouiines.c 

2.13.4.13 

siin_bal_traj_chord 

/cig/libsrc/Ubrtt/bal_routines.c 

2.13.4.8 

simulation 

/cig/libsrc/librtt/simulation.c 

2.13.43.1 

singlc_lite 

/cigAibsrc/libgossip/replace_mod.c 

2.9.18.2 

sio.closc 

/cig/libsrc/libsio/sio.c 

2.14.1.3 

siojnit 

/cig/libsrc/libsio/sio.c 

2.14.1.1 

sio_tick 

/cig/libsrc/libsio/sio.c 

2.14.1.4 

sio_wrile 

/cig/libsrc/libsio/sio.c 

2.14.1.2 

slave_cig_cnet_sync 

/cig/libsrc/libhost/host_enct_if.c 

2.10.2.4 

sload 

/cig/libsrc/libulii/sload.c 

2.16.5.1 

spur_ini 

/cig/othersrc/force/exception.asm 

2.18.2.2 

siaucveh_remove 

/cig/libsrc/librU/staticvch_remove.c 

2.13.44 

staticveh_state 

/cig/libsrc/librti/siaticveh_siate.c 

2.13.45 

status_mpvideo_prini 

/cig/libsrcAibmpvideo/mpvideo_print.c 

2.11.10.1 

stdopcn 

/cig/libsrc/libutil/stdopen  .c 

2.16.6 

strcat 

/cig/othersrc/force/ro_query.c 

2.18.22.3 

strcpy 

/cig/othersrc/foicc/lD_queiy.c 

2.18.22.2 

strlen 

/cig/othersrc/force/fD_query.c 

2.18.22.4 

swailow_token 

/cig/libsrc/Ubloken/lex.c 

2.15.1.6 

swap_axis 

/cig/libsrc/libru/mkmtx_nt.c 

2.13.33.5 

sys_control_init 

/cig/libsrc/Iibra/sys_control.c 

2.13.46.1 

sys_frame_ratc 

/cig/libsrc/librd/sys_conlrol.c 

2.13.46.2 

sys_master_sync 

/cig/libsrc/lilHlt/sys_control.c 

2.13.46.5 

sys_slave_sync 

/cig/libsrc/librtl/sys.control.c 

2.13.46.4 

syscrr 

/cig/libsrc/librtt/simulation.c 

2.13.43.3 

sysiem_aam_init 

/cig/libsrc/libconng/aam_manager.c 

2.5.1.3 

test_commands 

/cig/libsrc/libgossip/iest_commands.c 

2.9.19 

testesp 

/cig/othcrsrc/forceAcst _gsp.c 

2.13.37 

tick 

/cig/libsrc/libnea/tick.c 

2.7.26.2 

tick_init 

/cig/libsrc/libnea/tick.c 

2.7.26.1 

tick_main_menu 

/cig/libsrc/libflea/uck.c 

2.7.26.4 

tick_ppm 

/cig/libsrc/libnca/tick_ppm.c 

2.7.27.1 

tick_ppm_mcnu 

/cig/libsrc/libflea/tickjjpm.c 

2.7.27.2 

tick_ppm_menu_headcr 

/cig/libsrc/libnea/tick_ppm.c 

2.7.27.3 

tick_ppm_update_info 

/cig/libsrc/libnea/tick_ppm.c 

2.7.27.4 
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tick_script 

/cig/libsrc/libflea/tick_script.c 

2.7.28.1 

tick_script_main_menu 

/cig/libsrc/libflea/lick_'”;ript.c 

2.7.28.2 

toggle_mpvideo_print 

/cig/libsrc/libtnpvideo/inpvideo_print.c 

2.11.10.2 

translate 

/cig/libsrc/librtt/inkmtx_nt.c 

2.13.33.8 

trav_tree 

/cig/libsrc/libvpt/trav_tree.c 

2.17.17 

triple_lite 

/cig/libsrc/libgossipAeplace_mod.c 

2.9.18.4 

tst_edebug 

/cig/libsrc/libvptAst_c^bug.c 

2.17.18 

tst_equery 

/cig/libsrc/libvj)tAst_equery.c 

2.17.19.1 

tst_ereadconfig 

/cig/Ubsrc/libvpt/tst_ereadconfig.c 

2.17.20.1 

tst_eupdate 

/cig/libsrc/libvpt/tst_eupdate.c 

2.17.21 

tst_tree 

/cig/libsrc/libvpt/tst_tree.c 

2.17.22.1 

tst_treetrace 

/cig/libsrc/libvptAst_treetrace.c 

2.17.23.1 

upd_add_static_veh 

/cig/libsrc/libflea/encode_routincs.c 

2.7.4.9 

upd_auto_fire 

/cig/libsrc/libflea/encode_routines.c 

l.lA.l 

i^_chc*d_fired 

/cigAibsrc/libflea/encode.routines.c 

2.7.4.6 

upd.clouds 

/cig/libsrc/libflea/encode_routines.c 

2.7.4.14 

up(l_count_hits_per_min 

/cig/UbsrcAibflea/encode_routines.c 

2.7.4.11 

i^_dynainic_matrix 

/cig/libsrc/libnea/encode_iDutines.c 

2.7.4.3 

uixl_flea_vehicles 

/cig/libsrc/libflea/encode_ioutines.c 

2.7.4.24 

updjt_state 

/cig/libsrc/libflea/encode_ioutines.c 

2.7.4.30 

upd_matrix_values 

/cig/libsrc/libflea/encode_routines.c 

2.7.4. 1 

updjjpm 

/cig/libsrc/libnea/nea_ppm_obj.c 

2.7.18.1 

iijxl_rem_static_veh 

/cig/libsrc/libflea/encode_it)utines.c 

2.7.4.8 

uixl_req_agl 

/cig/libsrc/libnea/encode_routines.c 

2.7.4.15 

upd_req_lrange 

/cig/Ubsrc/libflea/encode_routines.c 

2.7.4.17 

upd_iEq_point 

/cig/libsrc/libnea/encode_routines.c 

2.7.4.16 

upd_rotation_values 

/cig/libsrc/libflea/encode_rouunes.c 

l.lA.l 

uixl_round_fired 

/cig/libsrc/libnea/encode_routines.c 

2.7.4.5 

uixl_send_dynamic 

/cig/libsrc/libflea/encode.iDUtines.c 

2.7.4.10 

upd_send_stop 

/cig/libsrc/libflea/encode_routines.c 

2.7.4.21 

uixl_show_eff 

/cig/libsrc/libflea/encodc.routines.c 

2.7.4.13 

upd_sio_wriie 

/cig/libsrc/libflea/encode_routines.c 

2.7.4.29 

uixl_subsys_mode 

/cig/libsrc/libnea/cncode_routines.c 

2.7.4.19 

upd_view_flags 

/cig/libsrc/libnea/encode_routines.c 

I.IAA 

uixl_view_mag 

/cig/libsrc/libflea/encode_toutines.c 

2.7.4.18 

uixl_view_niode 

/cig/libsrc/libflea/encode_iDutines.c 

2.7.4.12 

upd_viewpoii_up 

/cig/libsrc/libflea/encode_routines.c 

2.7.4.20 

updatc_2d 

/cig/libsFc/libflea/update_2d.c 

2.7.29 

uixlate_agpl_2d 

/cig/libs^c/libflea^^xlate_agpt_2d.c 

2.7.30 

updaie_dyn_demo 

/cig/libsrc/libflea/nea_agpt_localions.c 

1.1.1  A 

uixlaie_mag 

/cig/libsrc/libflea/nea_agpt_switches.c 

2.7.8.3 

updaie_inenu_header 

/cig/libsrc/libflea/tick.c 

2.7.26.6 

uiKlate_subsys_modc 

/cig/bbsrcAibnea/flea_agpt_switches.c 

1.1.%A 

updaie_vpt 

/cig/libsrc/libflea/nea_agpt_switches.c 

2.7.8.5 

upstart 

/cig/libsrc/librtt/upstart  c 

?  13.47.1 

upstart_cleanup 

/cig/IibsrcAibrtt/upstaitc 

2.13.47.2 

vasi_lite 

/cig/libsrc/libgossip/replacc_inod.c 

2.9.18.5 

vec_inat_niul 

/cig/libsrc/librtl/mkmu_nt.c 

2.13.33.20 

vpt_cnode_get 

/cig/libsrc/libvpt/cnode_getc 

2.17.3 

vpi_cnode_linkvpt 

/cig/libsrc/libvpt/linkvpi.c 

2.17.10 

vpt_cnode_process 

/cig/libsrc/libvpt/cnode_process.c 

2.17.4 

vpt_cnode_qroot 

/cig/libsic/libvpt/cnode_query.c 

2.17.5.2 

vpt_cnode_query 

/cig/libsrcAibvpt/cnode_query.c 

2.17.5.1 

vpt_cnode_sct_bchild 

/cig/libsrc/libvpt/cnode_child.c 

2.17.2.1 

vpt_cnode_set_branch 

/cig/libsrc/libvpt/cnodc_scLc 

2.17.6.1 

vpt_cnode_set_matrix 

/cigAibsrc/libvpt/cnodc_seLc 

2.17.6.2 

vpt_cnode_set_stdchild 

/cig/libsrc/libvpt/cnodc_child.c 

2.17.2.2 

vpt_inii_modc_off 

/cig/libsrc/libvpt/bc_stubs.c 

2.17.1.8 
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vpt_init_inode_on 

/cig/libsrc/libvpt/be_stubs.c 

2.17.1.7 

vpt_path_get 

/cig/libsrc/bbvpi/palh_initc 

2.17.15.1 

vpt_path_init 

/cig/libsrc/libvpt/path_iniLc 

2.17.15.2 

vpt_path_iHXKess 

/cig/libsrc/libvpt^alh.c 

2.17.14.1 

vpt_path_query 

/cig/libsrc/libvpt^ath_query.c 

2.17.16 

vpt_path_setup 

/cig/libsrc/libvpt^ath_iniLc 

2.17.15  3 

vpt_path_update 

/cig/libsrc/libvpti^ath.c 

2.17.14.2 

vpt_root_init 

/cig/Ubsrc/libvpt^nit_free.c 

2.17.9.1 

vpt_tree_ftee 

/cig/libsrc/Iibvpi^nit_fTee.c 

2.17.9.3 

vpt_tree_init 

/cig/libsrcAibvpt^init_firee.c 

2.17.9.2 

vpt_iipdate 

/cig/libsrc/libvpt/vpt_update.c 

2.17.35 

vpt_update_2xl_heading 

/cig/libsrc/libvpt/u_rotations.c 

2.17.26.1 

vpt_update_2xl_pitch 

/cig/libsrc/bbvpt/u_rotations.c 

2.17.26.2 

vpt_update_2xl_roll 

/cig/libsrc/libvpt/u_rotations.c 

2.17.26.3 

vpt_update_3x3_inatrix 

/cig/libsrc/libvpt/u_xfrmx 

2.17.28.2 

vpt_update_4x3_inatrix 

/cig/libsrc/libvpt/u_xfnn.c 

2.17.28.1 

vix_update_all 

/cig/libsrc/libvptAi_viewport.c 

2.17.27.7 

vpt_update_bnnask 

/cig/libsrc/libvpi/u_bnnask.c 

2.17.24 

vpt_iiixlate_fov 

/cig/libsrc/libvptAi_viewporl.c 

2.17.27.1 

vpt_update_fov_lod 

/cig/libsrc/Iibvpt/u_viewport.c 

2.17.27.2 

vpt_up(’ate_heading 

/cig/libsrc/libvpi/u_rotations.c 

2.17.26.4 

vpt_uixlate_hpr 

/cig/libsrc/libvpi/u_rotalions.c 

2.17.26.7 

vpt_update_hprxyzs 

/cig/libsrc/libvpt/u_xfnn.c 

2.17.28.3 

vpt_updateJodm 

/cig/libsrc/libvptAi_viewport.c 

2.17.27.3 

vpt_update_tntx 

/cig/libsrc/libvpi/update_mtx.c 

2.17.29 

vpt_uixlate_near_plane 

/cig/libsrc/libvpt/u_viewport.c 

2.17.27.4 

vpt_uixlate_one_path 

/cig/libsrc/libvpt/u_paih.c 

2.17.25 

vpt_update_pitch 

/cig/libsrc/libvpt/u_rotations.c 

2.17.26.5 

vpt_uixlate_rez 

/cig/libsrc/libvpt/u_viewpon.c 

2.17.27.5 

vpt_updaie_ro]l 

/cig/libsrc/libvpi/u_rotations.c 

2.17.26.6 

vpt_uixlate_rot 

/cig/libsrc/libvpt/update_roLc 

2.17.30 

vpt_update_scale 

/cig/libsrc/libvpc/u_xfrm.c 

2.17.28.4 

vpt_  update_translauon 

/cig/libsrc/Iibvpc/u_xfnn.c 

2.17.28.5 

vpt_up)date_view_range 

/cig/libsrc/libvpt/u_viewport.c 

2.17.27.6 

vpt_vpt_get 

/cig/libsrc/libvpt/vpi_get.c 

2.17.31 

vpt_vpt_process 

/cig/libsrc/libvpi/vpt_process.c 

2.17.32 

vpt_vpt_query 

/cig/libsrc/libvp|/vpt_query.c 

2.17.33 

vpt_vpt_set 

/cig/libsrc/libvpt/vpt_set.c 

2.17.34 

vpti_change_path_entry_index 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_change_vpt_entry_index 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_get_pathptr_cnode 

/cig/libsrc/Iibvpt/globs.c 

2.17.8 

vpti_get_ptr_cnode 

/cig/libsrc/libvpi/globs.c 

2.17.8 

vpti_get_ptr_path 

/cig/libsrc/libvpi/globs.c 

2.17.8 

vpti_get_pir_vpt 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_get_vpq3tT_cnode 

/cig/libsrcAibvpt/globs.c 

2.17.8 

vptijncrement_path_emry_index 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpo_increment_vpt_eniry_index 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpu  _set_ptr_ciK)de 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpu_set_ptr_path 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_set_ptr_vpt 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_set_state_dcnode 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_set_state_dJodmult 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpU_set_state_dmatrix 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpU_set_state_dpath 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_sel_state_dtproc 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_set_state_dtree_short 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_set_state_dvptnode 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_set_state_cdtpc 

/cig/libsrc/libvpt/globs.c 

2.17.8 

849 


BBN  Systems  and  Technologies 

GTIOORTSW  CSCI 

Function  Name 

Location 

Section 

vpti_set_state_efillt 

/cig/libsre/libvpt/globs.c 

2.17.8 

vpti_set_state_panel_align 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpd_state_dcnode 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_state_dlodmult 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_state_dmatrix 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_state_dpath 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_state_dtproc 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_state_dtree_shoit 

^ig/libsrc/libvpt/globs.c 

2.17.8 

vpti_state_dvptnode 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_staie_edtpc 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_state_efillt 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_state_panel_align 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_togstate_dciKxle 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_togstate_dlodmult 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_togstate_dmatrix 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_togstate_dpath 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_togstate_dtproc 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_togstate_dtree_short 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_togstate_dvptnode 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_togstate_ed^ 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_togstate_efillt 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_togstate _panel_align 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vpti_val_path_entry_index 

/cig/libsrcAibvpt/globs.c 

2.17.8 

vpti_val_vpt_entry_index 

/cig/libsrc/libvpt/globs.c 

2.17.8 

vptq_activept 

/cig/libsrc/libvpt^t_equery.c 

2.17.19.6 

vptq_lMvals 

/cig/libsrc/bbvpt/tst_equery.c 

2.17.19.5 

vptq_cnout 

/cig/libsrc/libvpti^t_equery.c 

2.17.19.9 

vpui_cnptrs 

/cig/libsrc/libvpt/tsi_cquery.c 

2.17.19.4 

vptq_dynmtx 

/cig/libsrc/libvpt/tst_equery.c 

2.17.19.8 

vptq_grout 

/cig/libsrc/libvpt/tst_equery.c 

2.17.19.11 

vptq_grptrs 

/cig/libsrc/libvptAst_equery.c 

2.17.19.2 

vptq_vpout 

/cig/libsrc/libvpt/tst_equery.c 

2.17.19.10 

vptq_vpptrs 

/cig/libsrc/libvj)t/tst_equery.c 

2.17.19.3 

vptq_vptbiout 

/cig/libsrc/libvi)t/ist_equery.c 

2.17.19.7 

what_node_on_stack 

/cig/libsrc/libgcndtp/dtp_funcs.c 

2.8.2.3 

whatdiiptr 

/cig/libsrc/librtt/lo^_modules.c 

2.13.30.4 

write_evc_control 

/cig/libsrc/librtt/sys_control.c 

2.13.46.8 

'vrite_evc_&ame 

/cig/libsrcAibrtt/sys_control.c 

2.13.46.9 
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E.4  Macro  Names  Mapped  To  Source  File  Locations 

The  following  list  shows  each  macro  function  used  by  the  real-time  software,  and  identifies 
the  file  in  which  the  macro  is  defined.  The  third  column  shows  the  section  number  in 
which  the  macro  is  described  in  this  document. 


Macro  Name 

Location 

Section 

AAMl  TO  AAM2 

/cig^clud^udge.h 

B.l 

AAM2_ADDR 

/cig^includ^unctions.h; 

/cig/libsrc/libconfig^roccss_vflags.c 

B.2 

AAREAD 

/cig/include/defLiitions.h 

B.3 

ABSVAL 

/cigAnclud^deflnitions.h,  rt_macros.h 

B.4 

BCOPY 

/cig/include^)x_defines.h 

B.5 

CHECK  FORCE 

/cig/libsrc/libgossip/gos_120tx.c,  gos_mpv.c 

B.6 

CHECKROT 

/cig/libsrc/libflea/flea_simulate_vehicles.c 

B.7 

CUBE 

/cig^nclude/rt.macFOS.h 

B.8 

DART  ENQUEUE 

/cig/include^unctions.h 

B.9 

DED  BOUNDARY 

/cig/libsrc/librtt/ded_model_trace.c 

B.IO 

DEGREE  TO  RADIAN 

/cigAncludeAt_m^ros.h 

B.ll 

DELETE  ROUND 

/cig/5nclud^x_m^os.h 

B.12 

DELETE  STAT  VEH 

/cig/includ^x_macros.h 

B.13 

DOWNLOAD_DATA 

/cig/libsrc/lib2d/cigjink_2d.c 

B.14 

dtp_bcn 

/cig/include/icinclude.h 

B.15 

dtp_bcnr 

/cig^liide/icinclude.h 

B.15 

d^_bcnrs 

/cig/inclu(W(cincludc.h 

B.15 

d^_bcns 

/cig^clude/rcinclude.h 

B.15 

dtp_bcz 

/cig/include/rcinclude.h 

B.15 

dtp_bczr 

/cig/includ^include.h 

B.15 

d5)_bczrs 

/cig/include^cinclude.h 

B.15 

dip_bczs 

/cig/include/rciiiclude.h 

B.15 

dtp_bdgr 

/cig/include/rcinclude.h 

B.15 

dtp_bdgrs 

/cig/include/rcinclude.h 

B.15 

d^_bdlr 

/cig/includ^rcinclude.h 

B.15 

dtp_bdlrs 

/cig/inclucWrcinclude.h 

B.15 

dtp_bgn 

/cigAnclude/tcinclude.h 

B.15 

dtp_bgns 

/cigAuiclude/rcinclude.h 

B.15 

d^_bgz 

/cig/includ^include.h 

B.15 

d^_bgzs 

/cig/include/rcincludc.h 

B.15 

d^_blin 

/cigAnclud^includc.h 

B.15 

dtp_bnz 

/cig/includeM;include.h 

B.15 

dtp_bnzr 

/cig^clude^include.h 

B.15 

d^_bnzrs 

/cigAuiclud^rcinc]ude.h 

B.15 

dtp_bnzs 

/cig/include/rcinclude.h 

B.15 

dtp_bpc 

/cig/include/rcinclude.h 

B.15 

dtp_l^x 

/cig/includi^include.h 

B.15 

dli)_bni 

/cigAnclude/rcinclude.h 

B.15 

d^_brur 

/cig^includeM:incIude.h 

B.15 

d^_brurs 

/cig/include^include.h 

B.15 

dtp_bnis 

/cig/include/rcinclude.h 

B.15 

d^_brz 

/cig/include/rciix;]ude.h 

B.15 

dtp_brzr 

/cig/inclucWrcinclude.h 

B.15 

dtp_brzrs 

/cig/include/rcinclude.h 

B.15 

dtp_brzs 

/cig/include/icinclude.h 

B.15 

dtp_dol 

/cig/include/rcinclude.h 

B.15 

dtp_elin 

/cig/include/rcincludc.h 

B.15 
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Macro  Name 

Location 

Section 

dlp_end 

/cig^clude/icinclude.h 

B.15 

d^_fov 

/cig^clude^include.h 

B.15 

dip_fovr 

/cigAinclud^include.h 

B.15 

dtp_fovrs 

/cig^clud^include.h 

B.15 

dtp_fovs 

/cig^clude^include.h 

B.15 

d5)_gdc 

/cig^clude^include.h 

B.15 

d^_gdci 

/cig^clude^cinclude.h 

B.15 

dtp_gdcir 

/cig^clud^icinclude.h 

B.15 

d^_gdcirs 

/cig^ludetteinclude.h 

B.15 

d^_gdcis 

/cig^clud^include.h 

B.15 

d^_gdcn 

/cig/includ^x;include.h 

B.15 

dip_gdcnr 

/cig^clud^include.h 

B.15 

di_gdcnrs 

/cigAncIude^include.h 

B.15 

d]p_gdcns 

/cig^clude/rcinclude.h 

B.15 

dJp_gdcr 

/cig^cludeiteinclude.h 

B.15 

d^_gdcrs 

/cig^clud^include.h 

B.15 

dtp_gdcs 

/cig^clude^include.h 

B.15 

dtp_gr 

/cig^clu(Wrcinclude.h 

B.15 

dtpjmi 

/cig/include/tciiiclude.h 

B.15 

dtpjmir 

/cig/include/rcinclude.h 

B.15 

dtpjmirs 

/cig/includ^include.h 

B.15 

dtp_linis 

/cig^clude/rcinclude.h 

B.15 

d^_lod 

/cigAnclude/rcinclude.h 

B.15 

dtpjodr 

/cig/includeAcinclude.h 

B.15 

d^Jodrs 

/cig^cludeAcinclude.h 

B.15 

d^Jods 

/cig^include/rcinclude.h 

B.15 

dipjwd 

/cig/include)^include.h 

B.15 

dtpjwdr 

/cig^clude/icinclude.h 

B.15 

dtpjwdrs 

/cig^cludeAcinclude.h 

B.15 

dipjwds 

/cig/includ^icinclude.h 

B.15 

dtp_minl 

/cig^include/icinclude.h 

B.15 

dtp_mmpre 

/cig/include/iciiiclude.h 

B.15 

dtp_mmpst 

/cig/includei^include.h 

B.15 

dq)_mwd 

/cig^clud^cinclude.h 

B.15 

dip_ngc 

/cig^cltxWicinclude.h 

B.15 

dq)_oio 

/cig^clude/tcincludc.h 

B.15 

dtp_CX5S 

/cig^include/icinclude.h 

B.15 

d4)_osd 

/cig^incliide/rcinclude.h 

B.15 

dtp_osds 

/cig/include/rcinclude.h 

B.15 

dtp_owd 

/cig/includ^icinclude.h 

B.15 

dtp_owds 

/cig/mclude/rcinclude.h 

B.15 

dlp_owdsc 

/cig/mclud^include.h 

B.15 

dtp_owo 

/cig/uiclude/rcinclude.h 

B.15 

dip_owr 

/cig/mclude/icinclude.h 

B.15 

d^_owrs 

/cig^clud^include.h 

B.15 

dlp_owrsc 

/cig/uiclude/rcinclude.h 

B.15 

d^_rc 

/cig/uiclude/icincludc.h 

B.15 

dtp_sub 

/cig/includeAcincludc.h 

B.15 

dtp_subr 

/cig/include/rcinclude.h 

B.15 

dtp_subrs 

/cig/include/rcincludc.h 

B.15 

dtp_subs 

/cig/includeAcinclude.h 

B.15 

dtp_tbc 

/cig/include/rcinclude.h 

B.15 

dQ)_tbdr 

/cig/include/rcinclude.h 

B.15 

dtp_tbdrs 

/cig/include/rcinclude.h 

B.15 

dtp_tbrr 

/cig/include/rcinclude.h 

B.15 

dtp  tbrrs 

/cig/include/rcincludc.h 

B.15 

DUMP  DART  BUFFER 

/cig/incl  ude/functions.h 

B.16 

ERRMSG 

/cig/libsrc/libgcndtp/rcfunc.s.c 

B.17 
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Macro  Name 

Location 

Section 

EXCHANGE  FLEA.DATA 

/cig/iiiclude^uncti(ms.h 

B.18 

FIND.LM 

/cigAnclud^functions.h,  rt_inacros.h 

B.19 

FLTOFX 

/cigAncliid^_inacros.h 

B.20 

FREE  LM  CACHE 

/cigAnclud^x_inacros.h 

B.21 

FXT0881 

/cig^nclude/funcdons.h,  it.macros.h 

B.22 

FXTOFL 

/cig/includeAt.macros.h 

B.23 

GET  CHORD  END 

/cigAnclud^x_inacros.h 

B.24 

GET  DB  POS 

/cig^nclude/bx_macros.h 

B.25 

GET  LB  FROM  LM 

/cig^nclude/bx_macros.h 

B.26 

GLOB 

/cigAnclude/ememory_map.h,  memory_map.h 

B.27 

INCR.COMPONENT 

/cig/Iibsic/libgendtp/rcfuncs.c 

B.28 

INIT_MTX 

/cigAnclude/dinctions.h,  rt_macros.h 

B.29 

MAGSQ2D 

/cig^ncliideAt_inacros.h 

B.30 

MAGSQ3D 

/cig^includ^.macros.h 

B.31 

MALLOC 

/cig/iiiclude/bx_derines.h 

B.32 

MAX 

/cigAnclude/rt_inacros.h 

B.33 

MIN 

/cigAncludeAt_macros.h 

B.34 

NEW  ROUND 

/cigAncliide/bx_macros.h 

B.35 

NEW  STAT  VEH 

/cigAnclude^x_macros.h 

B.36 

OPEN  FLEA  DATA 

/cig/includeA^unctions.h 

B.37 

OUTPUT.MESSAGE 

/cig/Ubsrc/libflea/cf_translator.c, 

flea_init_cig_sw.c 

B.38 

PAGE.FORMAT 

/cig/libsrc/libbaliybx_probe.c 

/cig/libsrc/libgossip/gos_bal_query.c 

B.39 

poly_ab 

/cig/include/icinciude.h 

B.40 

poly_bvc 

/cig/includeAcinclude.h 

B.40 

poly_efs 

/cig/includ^include.h 

B.40 

poly_efsr 

/cig^clude/rcinclude.h 

B.40 

poly_flu 

/cigTinclucWtcinclude.h 

B.40 

poly_fsw 

/cig;^clud^include.h 

B.40 

poly_gc 

/ci^clude/icinclude.h 

B.40 

poly_inf 

/cig/includeAcincIude.h 

B.40 

polyjmf 

/cig/include/rcinciude.h 

B.40 

poly_lsc 

/cig/include/rciiiclude.h 

B.40 

poly_mmf 

/cig/include/icinclude.h 

B.40 

poly_pc 

/cig/inclu(Wrcinc]ude.h 

B.40 

poly_poly 

/cig^clude/icinclude.h 

B.40 

poly_nnl 

/cig/include/rcinclude.h 

B.40 

poly_rm2 

/cig/include/rcinclude.h 

B.40 

poly_nn3 

/cig/include/icinclude.h 

B.40 

poly_nn4 

/cigAnclude/rcinclude.h 

B.40 

poly_sc 

/cig^cludeAcinclude.h 

B.40 

poly_sci 

/cigAncIude/icinc]ude.h 

B.40 

poly_sec 

/cig^clud^include.h 

B.40 

poly_sml 

/cigAnclude/iicinclude.h 

B.40 

poly_sin2 

/cig^clude/icinclude.h 

B.40 

poly_sm3 

/cig/includeAcinclude.h 

B.40 

poIy_sin4 

/cigAncIude^include.h 

B.40 

poly_stainp 

/ci^includei^include.h 

B.40 

poly.tog 

/cig/include/icinclude.h 

B.40 

poly_vtxe 

/cig/includ^include.h 

B.40 

poly  vtxl 

/cig/incIudeAcinclude.h 

B.40 

POP  STACK 

/cig/libsic/libr«/ded_modeLtrace.c 

B.41 

PRINTD4 

/cig/libsrc/Iibgossip/gos_memory.c 

B.42 

PRINTD8 

/cig/libsrc/libgossip/gos_memory.c 

B.43 

PRINTHEX4 

/cig/libsrc/bbgossip/gos_memory.c 

B.44 

PRINTHEX8 

/cig/libsrc/Ubgossip/gos_memory.c 

B.45 

PUSH  STACK 

/cig/libsrc/librtt/ded_model_trace.c 

B.46 
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Macro  Name 

Location 

Section 

RADIAN  TO  DEGREE 

/cig^ncludeAt_inacros.h 

B.47 

ROOM4LABEL 

/cig/libsic/til%endtp/icfuncs.c 

B.48 

ROOMCHECK 

/cig/libsic/Iii^end^rcfuncs.c 

B.49 

SEND  TF  INFO 

/cig/libsrc/librtt/bal_routines.c 

B.50 

SET  OUT  BITS 

/cig/incIu(k/definitions.h 

B.51 

SET  OUT  M2BITS 

/cig/include/definiticms.h 

B.52 

SET  PPM  DISPLAY  OFFSET 

/cig/libsrc/libfleaAick_ppm.c 

B.53 

SET  PPM  PDCEL  LOCATION 

A:ig/Iibsrc/libfleaAick_ppin.c 

B.54 

SIGN 

/cigAncIud^_inacros.h 

B.55 

SQUARE 

/cig/includ^_inacios.h 

B.56 

SYSERR 

/cig/include^unctions.h 

B.57 

TODEG 

/cig/libsrc/libflea/flea_simulate_vehicles.c 

B.58 

TORAD 

<miiltiple  files;  see  section  B.S9> 

B.59 

tcvadians 

/cig^cliKWdig_dennes.h,  vpi_viewport.h; 
/cigAibsrc/bbitt/make_bbn.c,  inkmtx_nt.c. 

model_mu.c 

B.60 

TRIGGER  FORCE 

A:ig/include/functions.h 

B.61 

VME_TO_VMX 

/cig/include/kludge.h;/cig/libsrc/librtl/cal.c; 

/cig/iibsfc/libmsg/msg_calibration_image.c, 

msg_effecLc,  msg_veh_state.c 

B.62 

WATT  FORCE 

/cig/include^unctions.h 

B.63 

WATT  MPVIO 

/cig/includeAnpvideo.h 

B.64 

WATT  MPVREPLY 

/cig/libsrc/libmpvideo/bootmpv.c 

B.65 

XCLOSE 

/cig/include/de^itions.h 

B.66 

XLSEEK 

/cig/include/definitions.h 

B.67 

XOPEN 

/cig/include/derinitions.h 

B.68 

XREAD 

/cig/include/definitions.h 

B.69 

XWRITE 

/cig/incIude/derinitions.h 

B.70 
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• 

INDEX  BY  SECTION  NUMBER 

2-D  Overlay  Compiler  (/cig/libsrc/lib2d) 

2.2 

aam_free 

2.17.1.9 

aam_malloc 

2.5.1. 1 

aam_manager.c 

2.5.1 

aa_init.c 

2.3.1 

active_arca_init 

2.3.1. 1 

addr_in_pool 

2.13.15.3 

agptjnitc 

2.13.1 

agpt_statistics.c 

2.9.1 

autopiloLc 

2.7.1 

bO_aam_centroid.c 

2.4.2.1 

bO_aam_sw_comer.c 

2.4.2.2 

bO_add_static_vehicle.c 

2.4.2.3 

bO_add_traj_table.c 

2.4.2.4 

bO_bal_config.c 

2.4.2.5 

bO_bvol_entry.c 

2.4.2.6 

bO_cancel_round.c 

2.4.2.7 

bO_cig_frame_rate.c 

2.4.2.8 

bO_database_info.c 

2.4.2.9 

• 

bO_delete_static_vehicle.c 

2.4.2.10 

bO_delete_traj_table.c 

2.4.2.11 

bO_error_detected.c 

2.4.2.12 

bO_inapp_message.c 

2.4.2.13 

bO_lm_read.c 

2.4.2.14 

bO_model_directory.c 

2.4.2.15 

bO_model_entry.c 

2.4.2.16 

bO_new_frame.c 

2.4.2.17 

bO_print.c 

2.4.2.18 

bO_process_chord.c 

2.4.2.19 

bO_process_round.c 

2.4.2.20 

bO_round_fired.c 

2.4.2.21 

bO_state_control.c 

2.4.2.22 

bO_status_request.c 

2.4.2.23 

bO_tf_init_hdr.c 

2.4.2.24 

bO_tf_init_pLc 

2.4.2.25 

bO_tf_state.c 

2.4.2.26 

bO_tf_vehicle_pos  .c 

2.4.2.27 

bO_traj_chord.c 

2.4.2.28 

bO_traj_entry.c 

2.4.2.29 

bO_undefined_message.c 

2.4.2.30 

• 

Backend  Manager  (/cig/libsrc/Iibbackend) 

2.3 
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backend_branch.c  (backend_set_branch) 

2.3.2 

backend_clear_laser_requests 

2.3.5.6 

backend_color.c  (backend_set_color) 

2.3.3 

backend_get_object_addr 

2.3.5.5 

backendjaser.c 

2.3.4 

backend_laser_request_range 

2.3.4.1 

backend_man.c 

2.3.5 

backend_paths.c 

2.3.6 

backend_rcset 

2.3.5.2 

backend_response 

2.3.4.2 

backend_send_req 

2.3.5.4 

backend_setup 

2.3.5.1 

backend_set_paths 

2.3.6.1 

backend_sim_init 

2.3.5.3 

backend_thermal.c  (backend_set_thermal) 

2.3.7 

backend_update_view_paths 

2.3.6.2 

backend_video.c  (backend_set_video) 

2.3.8 

Ballistics  Database  Interaction 

2.4.3 

Ballistics  Interface  Message  Processing 

2.4.2 

Ballistics  Mainline 

2.4.1 

Ballistics  Message  Queue  Management 

2.4.4 

Ballistics  Processing  (/cig/Ubsrc/libball) 

2.4 

ball_effect_add.c 

2.13.5 

bal_buffer_setup 

2.13.10.2 

bal_get_db_pos.c 

2.13.2 

bal_get_lm _grid.c 

2.13.3 

bal_routines.c 

2.13.4 

bbnctype.c 

2.5.2 

be_query  _buf fer_off set 

2.17.1.3 

be_query_dbO 

2.17.1.4 

be_query_lm_per_lmb_side 

2.17.1.6 

be_query_num_paths 

2.17.1.1 

be_qulm 

2.17.1.5 

be_stubs.c 

2.17.1 

bit_blt.c  (setup_bit_blt) 

2.2.1 

blank 

2.16.7.6 

blcopy.c 

2.16.1 

bootforce 

2.11.1.1 

bootforce.c 

2.11.1 

bootmpv.c 

2.11.2 

buffer_errors.c 

2.9.2 

bxl47_main.c 

2.1.1 

bx_bvol_int.c 

2.4.3.1 
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bx_chord_intersect.c 

2.4.3.2 

bx_compute_round.c 

2.4.3.3 

bx_delete_round 

2.4.3.5.2 

bx_delete_stat_veh 

2.4.3.5.10 

bx_dist_sq_pt_line 

2.4.3.5.11 

bx_find_round_hit 

2.4.3.3.5 

b7i_fiiid_fihot_report 

2.4.3.3.3 

bx_find_vehicle.c 

2.4.3.4 

bx_free_lm_cache 

2.4.3, 5,6 

bx_functions.c 

2.4.3.5 

bx_get_chord_end 

2.4.3.5.4 

bx_get_db_pos 

2.4.3.5.3 

bx_get_lb_from_lm 

2.4.3.5.8 

bx_get_lni_data.c 

2.4.3.6 

bx_get_lni_grid.c 

2.4.3.7 

bx_guntip_within_db 

2.4.3.3.2 

bx_init.c 

2.4. 1.1 

bx_model_int.c 

2.4.3.8 

bx_new_bvol 

2.4.3.5.5 

bx_new_poly 

2.4.3.5.7 

bx_new_round 

2.4.3.5.1 

bx_new_stat_veh 

2.4.3.5.9 

bx_poly_im.c 

2.4.3.9 

bx^probe.c 

2.4.1.2 

bx_reset.c 

2.4.1.3 

bx_retum_miss 

2.4.3.3.1 

bx_round_tracer_position 

2.4.3.3.4 

bx_task 

2.4.1.4.1 

bx_task.c 

2.4.1.4 

bx_task_cleanup 

2.4.1.4.2 

bx_tf_copy_msg 

2.4.3.10.4 

bx_tf_free_tf_pts 

2.4.3.10.7 

bx_tf_imt_pt_cache 

2.4.3.10.1 

bx_tf_new_tf_pts 

2.4.3.10.6 

bx_tf_next 

2.4.3.10.3 

bx_tf_pack.c 

2.4.3.10 

bx_tf_pts 

2.4.3.10.2 

bx_tf4)t_data 

2.4.3.10.5 

bx_trajectory.c 

2.4.3.11 

cal.c 

2.13.6 

canceLround 

2.7.4.28 

cf_transIator.c 

2.7.2 

check_restart 

2.1.3.2 

iii 
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check_sum 

CIG 

CIG  Configuration  (/cig/libsrc/libconfig) 

CIG-SIM  Communication 

cigsimio_buffer_init 
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mtx_perspective 

2.17.13.2 

mtx_viewspace.c 

2.17.13 

multmatrix 

2.13.32.5 

mult_4x3mtx 

2.13.33.9 

inx2_em)r 

2.13.35.5 

mx2_error 

2.18.34.5 

mx2_hwcopy 

2.13.35.6 

mx2_hwcopy 

2.18.34.6 

mx2_hword.c 

2.13.35 

mx2_hword.c 

2.18.34 

nix2_open 

2.13.35.1 

mx2_open 

2.18.34.1 

mx2_peek 

2.13.35.3 

mx2_peek 

2.18.34.3 
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mx2_push 

2.13.35.2 

nix2_push 

2.18.34.2 

mx2_skip 

2.13.35.4 

mx2_sHp 

2.18.34.4 

mx3_error 

2.9.17.5 

mx3_hwcopy 

2.9.17.6 

mx3_hword.c 

2.9.17 

mx3_open 

2.9.17.1 

mx3_peek 

2.9.17.3 

nix3_push 

2.9.17.2 

mx3_skip 

2.9.17.4 

mx_error.c 

2.4.4.1 

mx_open.c 

2.4.4.2 

mx_peek.c 

2.4.4.3 

inx_push.c 

2.4.4.4 

mx_skip.c 

2.4.4.5 

mx_wcopy.c 

2.4.4.6 

new_pos_orient 

2.7.7. 3 

next_char 

2.15.1.2 

next_line 

2.15.1.5 

next_token 

2.15.1.4 

nmi_type.c 

2.18.35 

old_mtx_perspective 

2.17.13.3 

OpenDir 

2.16.2.1 

open_dbase 

2.13.36.1 

open_dbase.c 

2.13.36 

open_ded.c 

2.13.37 

open_drl  l_interface 

2.10.1.1 

open_enet_interface 

2.10.2.1 

open_flea_interface 

2.10.3.1 

open_mpv_interface 

2.10.5.1 

open_scsi_interface 

2.10.6.1 

open_socket_interface 

2.10.7.1 

otherveh_state.c 

2.13.38 

outahere 

2.9.18.6 

outdisplay 

2.9.4.3 

oval_rect.c  (setup_oval_rectangle) 

2.2.10 

overlay_setup.c 

2.5.7 

parse_subsys_file 

2.15.2.2 

path.c 

2.17.14 

path_init.c 

2.17.15 

path_query.c  (vpt_path_query) 

2.17.16 

pix_mult 

2.1.2.4 
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poll_ready.c 

2.18.36 

polLshutdown 

2.1. 1.2 

polLshutdown 

2.1.3.5 

poly.c  (setup_poly) 

2.2.11 

pool_get_off_24 

2.13.15.2 

pooMnit 

2.13.15.1 

pop_node 

2.8.2.2 

power 

2.5.4.2 

ppm_get_data 

2.3.10.3 

ppni_init 

2.3.10.2 

ppmjoad 

2.3.10.4 

ppm_obj.c 

2.3.10 

ppm_setup 

2.3.10.1 

pretend_veh.c 

2.13.39 

print_msg.c 

2.12.19 

print_msg_* 

2.12.19.1 

printjxibase 

2.13.12.4 

process_2d_setup 

2.7.2.14 

process_add_traj_table 

2.7.2.12 

process_agl_setup 

2.7.2.10 

process_animo_define 

2.7.2.19 

process_a_msg 

2.13.43.2 

process_chord 

2.7.4.26 

process_cig_ctl 

2.7.2.2 

process_configtree_node 

2.7.2.4 

process_define_tx_mode 

2.7.2. 6 

process_drl  l_pkt_size 

2.7.2.16 

process_file_description 

2.7.2.3 

process_lt_state 

2.7.2.15 

process_overlay_setup 

2.12.1 

process_ppm_display_mode 

2.7.2.20 

process_ppm_display_offset 

2.7.2.21 

process_ppin_pixel_location 

2.7.2.22 

process_ppm_pixel_state 

2.7.2.23 

process_round 

2.7.4.27 

process_sio_close 

2.7.2.17 

process_sio_init 

2.7.2.11 

process_tf_init_hdr 

2.1.1.% 

process_tf_init_pt 

2.1.2.9 

process_tf_state 

2.7.2.18 

process_traj_entry 

2.7.2.13 

process_vflags.c 

2.5.8 

process_viewport_state 

2.1.2.5 
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process_vppos.c 

2.5.9 

proc_cmd.c  (process_command) 

2.2.12 

prtackerr 

2.11.2.3 

prtmsgerr 

2.11.2.2 

prtstaterr 

2.11.2.4 

prt_intx 

2.13.32.1 

pr_branch 

2.17.23.2 

pr_iiiatrix 

2.17.23.3 

push_node 

2.8.2.1 

put_in_hdr 

2.7.4.23 

p_configtree_ncxie 

2.17.20.2 

p_overlay_setup 

2.17.20.4 

p_terrrain_feedback 

2.17.20.6 

p_viewport_state 

2.17.20.3 

r4niat_dump 

2.17.12.1 

r8mat_dump 

2.17.12.2 

rcfuncs.c 

2.8.5 

rcl_command 

2.8.5.11 

rcLcomponent 

2.8.5.12 

rcLdata 

2.8.5.13 

rcl_init_adrs 

2.8.5.6 

rcl_init_stack 

2.8.5. 1 

rcLIblcmd 

2.8.5.10 

rcl_patch_adrs 

2.8.5.4 

rcLpop 

2.8.5.3 

rcLpush 

2.8.5.2 

rcl_rtn_adrs 

2.8.5.7 

rcl_set_cntlbl 

2.8.5.9 

rcl_set_errptr 

2. 8.5.5 

rcl_set_label 

2.8.5.8 

rcl_set_modloc 

2.9.10.2 

rcl_stuff_data 

2.8.5.14 

ReadDir 

2.16.2.2 

read_a_keyword 

2.7.2.24 

read_evc_control 

2.13.46.7 

Real-Time  Processing  (/cig/libsrc/librtt) 

2.13 

red_clock 

2.18.32.4 

remove_comment_lines 

2.7.2.26 

renK)ve_white_space 

2.7.2.25 

replace_mod 

2.9.18.1 

replace_mod.c 

2.9.18 

Resource  Utilization 
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restart_clock 

2.18.32.3 
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restore_cur 

2.16.7.8 

retum_aam_ptr 

2.5.1.2 

md 

2.13.9.8 

TX)tate_x 

2.13.32.2 

rotate_x_nt 

2.13.33.2 

rotate_y 

2.13.32.3 

rotate_y_nt 

2.13.33.3 

rotate_z 

2.13.32.4 

rotate_z_nt 

2.13.33.4 

rowcol_rd.c 

2.13.40 

rowcol_id_l 

2.13.40.1 

rowcol_rd_  l_cleanup 

2.13.40.6 

rowcol_rd_2 

2.13.40.2 

rowcol_rd_2_cleanup 

2.13.40.7 

rowcol_rd_3 

2.13.40.3 

rowcol_rd_3_cleanup 

2.13.40.8 

rowcol_rd_4 

2.13.40.4 

rowcol_td_4_cleanup 

2.13.40.9 

rtn_entryj)t 

2.11.1.3 

RTSW  Software  Structure 

1.3 

rtt.c 

2.1.3 

rtt_mit.c 

2.13.42 

rtt_shutdown 

2.1.3.4 

rt_accept 

2.13.41.3 

rt_mailbox.c 

2.13.41 

rt_pend 

2.13.41.1 

rt_post 

2.13.41.2 

save_cur 

2.16.7.7 

scale_mtx 

2.13.33.7 

scan_number 

2.15.1.3 

scratch_flea 

2.7.5.9 

scroll_reg 

2.16.7.9 

send_ammo_define 

2.7.4.32 

send_data 

2.16.5.3 

send_gun_overlay 

2.7.4.31 

Serial  Device  Input/Output  (/cig/libsrc/libsio) 

2.14 

setup_p_terrain_feedback 

2.17.20.5 

set_3d_lut_name 

2.15.2.13 

set_color_config_name 

2.15.2.16 

set_command_2d 

2.7.8.2 

set_database_name 

2.15.2.10 

set_data_2d_name 

2.15.2.14 

set_ded_name 

2.15.2.11 
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set_entry_pt 

2.11.1.2 

set_esifa_name 

2.15.2.15 

set_fmal_lut_name 

2.15.2.12 

setjeds 

2.13.46.3 

setjut 

2.13.9.7 

set_token_file 

2.15.1.1 

se_clock 

2.18.32.5 

sgr 

2.16.7.2 

uhot_report.c 

2.4.3.12 

show_effect_msg.c 

2.12.20 

simulation 

2.13.43.1 

Simulation  Host 

1.1.1 

simulation.c 

2.13.43 

Simulator 

1.1 

sim_bal_agl_wanted 

2.13.4.5 

sim_bal_frame_rate 

2.13.4.3 

sim_bal_init 

2.13.4.1 

sim_bal_process_msg 

2.13.4.6 

sim_bal_process_tracer 

2.13.4.7 

sim_bal_req_pt_info 

2.13.4.4 

sim_b£d_reset 

2.13.4.12 

sim_bal_round_fired 

2.13.4.9 

sim_bal_start 

2.13.4.2 

sim_bal_static_add 

2.13.4.10 

sim_bal_static_rem 

2.13.4.11 

sim_bal_tf_veh_update 

2.13.4.13 

sim_bal_traj_chord 

2.13.4.8 

single_lite 

2.9.18.2 

sio.c 

2.1<.l 

sio_close 

2.14.1.3 

sio_init 

2.14.1.1 

sio_tick 

2.14.1.4 

sio_write 

2.14.1.2 

slave_cig_enet_sync 

2.10.2.4 

sload 

2.16.5.1 

sload.c 

2.16.5 

spur_int 

2.18.2.2 

Stand-Alone  Host  Emulator  (/cig/libsrc/libflea) 

2.7 

staticveh_remove.c 

2.13.44 

staticveh_state.c 

2.13.45 

status_mpvideo_print 

2.11.10.1 

stdopen.c 

2.16.6 

strcat 

2.18.22.3 
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strcpy 

2.18.22.2 

string.c  (setup_define_string) 

2.2.13 

strlen 

2.18.22.4 

subsys_cfg_parse.c 

2.15.2 

swallow_token 

2.15.1.6 

swap_axis 

2.13.33.5 

syserr 

2.13.43.3 

System  Utilities  (/cig/libsrc/libutil) 

2.16 

system_aam_init 

2.5.1.3 

sys_control.c 

2.13.46 

sys_control_init 

2.13.46.1 

sys_frame_rate 

2.13.46.2 

sys_master_sync 

2.13.46.5 

sys_slave_sync 

2.13.46.4 

s_step 

2.9.15.4 

Task  Initialization  (/cig/gtbinsrc) 

2.1 

test_commands.c 

2.9.19 

test_gsp.c 

2.18.37 

texLc  (setup_text) 

2.2.14 

tick 

2.7.26.2 

tick.c 

2.7.26 

tick_init 

2.7.26.1 

tick_main_menu 

2.7.26.4 

tick_ppm 

2.7.27.1 

tick_ppm.c 

2.7.27 

tick_ppm_menu 

2.7.27.2 

tick_ppm_nienu_header 

2.7.27.3 

tick_ppm_update_info 

2.7.27.4 

tick_script 

2.7.28.1 

tick_scripLc 

2.7.28 

tick_script_main_menu 

2.7.28.2 

toggle_mpvi(leo_print 

2.11.10.2 

Token  Processing  (/cig/libsrc/libtoken) 

2.15 

translate 

2.13.33.8 

trav_tree.c 

2.17.17 

triple_lite 

2.9.18.4 

tst_edebug.c 

2.17.18 

tst_equery 

2.17.19.1 

tst_equery.c 

2.17.19 

tst_ereadconfig 

2.17.20.1 

tst_ereadconfig.c 

2.17.20 

tst_eupdate.c 

2.17.21 

tst_tree 

2.17.22.1 
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tst_tree.c 

2.17.22 

tst_treetrace 

2.17.23.1 

tst_trcetrace.c 

2.17.23 

update_2d.c 

2.7.29 

update_agpt_2d.c 

2.7.30 

update_dyn_demo 

2.7.7.4 

update_mag 

2.7.8.3 

update_nienu_header 

2.7.26.6 

update_mtx.c  (vpt_update_mtx) 

2.17.29 

update_rot.c  (vpt_update_rot) 

2.17.30 

update_subsys_mode 

2.7.8.4 

update_vpt 

2.7.8.5 

upd_add_static_veh 

2.7.4.9 

upd_auto_fiie 

2.7.4.7 

upd_chord_fired 

2.7.4.6 

upd_clouds 

2.7.4.14 

upd_count_hits_per_min 

2.7.4.11 

upd_dynamic_matrix 

2.7.4.3 

upd_flea_vehicles 

2.7.4.24 

upd_lt_state 

2.7.4.:0 

upd_matrix_values 

2.7.4.1 

upd_ppm 

2.7.18.1 

upd_rem_static_veh 

2.7.4.8 

upd_req_agl 

2.7.4.15 

upd_req_lrange 

2.7.4.17 

upd_req_point 

2.7.4.16 

upd_ix)tation_values 

2.7.4.2 

upd_round_fired 

2.7.4.5 

upd_send_dynamic 

2.7.4.10 

upd_send_stop 

2.7.4.21 

upd_show_eff 

2.7.4.13 

upd_sio_write 

2.7.4.29 

upd_subsys_mode 

2.7.4.19 

upd_viewport_up 

2.7.4.20 

upd_view_flags 

2.7.4.4 

upd_view_mag 

2.7.4.18 

upd_view_mode 

2.7.4.12 

upstart 

2.13.47.1 

upstart.c 

2.13.47 

upstart_cleanup 

2.13.47.2 

User  Interface  Mode  (/cig/libsrc/libgossip) 

2.9 

u_brmask.c  (vpt_update_bnnask) 

2.17.24 

u_comp_2d.c  (compile_2d) 

2.2.15 

XXI 


u_getm_2d.c  (get_msg_2d) 

2.2.16 

u_link_2d.c  (linkup) 

2.2.17 

u_main2<Lc  (main) 

2.2.18 

u_path.c  (vpt_update_one_path) 

2.17.25 

u_rotations.c 

2.17.26 

u_viewport.c 

2.17.27 

u_xfrm.c 

2.17.28 

vasLlite 

2.9.18.5 

vec_mat_mul 

2.13.33.20 

Viewport  Configuration  (/cig/libsrc/libvpt) 

2.17 

vptq_activept 

2.17.19.6 

vptq_brvals 

2.17.19.5 

vptq_cnout 

2.17.19.9 

vptq_cnptrs 

2.17.19.4 

vptq_dynmtx 

2.17.19.8 

vptq_grout 

2.17.19.11 

vptq_grptrs 

2.17.19.2 

vptq_vpout 

2.17.19.10 

vptq_vpptrs 

2.17.19.3 

vptq_vptbrout 

2.17.19.7 

vpt_cnode_qroot 

2.17.5.2 

vpt_cnode_query 

2.17.5.1 

vpt_cnode_set_bchild 

2.17.2.1 

vpt_cnode_set_branch 

2.17.6.1 

vpt_cnode_set_matrix 

2.17.6.2 

vpt_cnode_set_stdchild 

2.17.2.2 

vpt_get.c  (vpt_vpt_get) 

2.17.31 

vpt_init_niode_off 

2.17.1.8 

vpt_init_mode_on 

2.17.1.7 

vpt_path_get 

2.17.15.1 

vpt_path_init 

2.17.15.2 

vpt_path_process 

2.17.14.1 

vpt_path_setup 

2.17.15.3 

vpt_path_update 

2.17.14.2 

vpt_process.c  (vpt_vpt_process) 

2.17.32 

vpt_query.c  (vpt_vpt_query) 

2.17.33 

vpt_root_init 

2.17.9.1 

vpt_set.c  (vpt_vpt_set) 

2.17.34 

vpt_tree_fipee 

2.17.9.3 

vpt_tree_init 

2.17.9.2 

vpt_update.c 

2.17.35 

vpt_update_2x  1  _heading 

2.17.26.1 

vpt_update_2x  1  _pitch 

2.17.26.2 

XXll 


BBN  Systems  and  Technologies 


GTIOO  RTSW  CSCI 


vpt_update_2x  1  _roll 

2.17.26.3 

vpt_update_3x3_matrix 

2.17.28.2 

vpt_update_4x3_niatrix 

2.17.28.1 

vpt_update_all 

2.17.27.7 

vpt_update_fov 

2.17.27.1 

vpt_update_fov_lod 

2.17.27.2 

vpt_update_heading 

2.17.26.4 

vpt_update_hpr 

2.17.26.7 

vpt_update_hprxyzs 

2.17.28.3 

vpt_update_lodm 

2.17.27.3 

vpt_update_near_plane 

2.17.27.4 

vpt_update_pitch 

2.17.26.5 

vpt_updatejrez 

2.17.27.5 

vpt_update_roll 

2.17.26.6 

vpt_update_scale 

2.17.28.4 

vpt_update_translation 

2.17.28.5 

vpt_update_view_range 

2.17.27.6 

vtlOO.c 

2.16.7 

whatdirptr 

2.13.30.4 

what_node_on_stack 

2.8.2.3 

window.c  (setup_define_window) 

2.2.19 

write_evc_control 

2.13.46.8 

write_evc_frame 

2.13.46.9 

_copy_reconfigurable_viewports_section 

2.12.6.13 

_database_disable 

2.12.6.10 

_display_lights 

2.12.6.3 

_downcount_effects 

2.12.6.2 

_handle_point_lights 

2.12.6.11 

_handle_rcquest_lcx:al_teiTain 

2.12.6.9 

_move_load_niodule_stp_to_quad_buffer 

2.12.6.4 

_pend_on_frame_interrupt 

2.12.6.6 

_process_agl 

2.12.6.7 

_reset_model_pointers 

2.12.6.12 

_rowcol_rd 

2.13.40.5 

_rowcol_rd_cleanup 

2.13.40.10 

_set_up_for_next_franie 

2.12.6.8 

_update_second_active_area_niemory 

2.12.6.5 
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